sayren 0.7.0 → 0.8.1

package/dist/index.mjs

@@ -965,7 +965,7 @@ const cli_app_dev_store_name_required = ((inputs = {}, options = {}) => {
 /** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
 /** @typedef {{ dir: NonNullable<unknown> }} Cli_App_Dir_ExistsInputs */
 const ko_cli_app_dir_exists = (i) => {
-	return `${i?.dir}에 이미 sayren.app.json이 있습니다`;
+	return `${i?.dir}에 이미 매니페스트(manifest.json)가 있습니다`;
 };
 /**
 
@@ -1037,7 +1037,7 @@ const cli_app_handle_mismatch = ((inputs, options = {}) => {
 /** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
 /** @typedef {{ events: NonNullable<unknown> }} Cli_App_Handler_MissingInputs */
 const ko_cli_app_handler_missing = (i) => {
-	return `매니페스트(events·schedules·http.public)에 있지만 코드에 함수가 없습니다: ${i?.events} (HANDLER_MISSING)`;
+	return `매니페스트(events·schedules·http.public·flow.notifications·mcp.tools)에 있지만 코드에 함수가 없습니다: ${i?.events} (HANDLER_MISSING)`;
 };
 /**
 
@@ -1200,6 +1200,24 @@ const cli_app_manifest_invalid = ((inputs, options = {}) => {
 	return ko_cli_app_manifest_invalid(inputs);
 });
 
+//#endregion
+//#region ../i18n/src/paraglide/messages/cli_app_manifest_legacy.js
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+/** @typedef {{}} Cli_App_Manifest_LegacyInputs */
+const ko_cli_app_manifest_legacy = () => {
+	return `sayren.app.json은 옛 매니페스트 이름입니다. 파일 이름을 manifest.json으로 바꾸십시오`;
+};
+/**
+
+* @param {Cli_App_Manifest_LegacyInputs} inputs
+* @param {{ locale?: "ko" }} options
+* @returns {LocalizedString}
+*/
+const cli_app_manifest_legacy = ((inputs = {}, options = {}) => {
+	experimentalStaticLocale ?? options.locale ?? getLocale();
+	return ko_cli_app_manifest_legacy(inputs);
+});
+
 //#endregion
 //#region ../i18n/src/paraglide/messages/cli_app_manifest_missing.js
 /** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
@@ -5257,6 +5275,8 @@ const ko_cli_usage = (i) => {
   --data <json>        app trigger: 이벤트 데이터
   --order <orderId>    app trigger: 주문 id를 데이터에 넣습니다
   --schedule <이름>    app trigger: 이벤트 대신 예약 작업을 실행합니다
+  --flow <이름>        app trigger: 이벤트 대신 흐름 알림을 보냅니다(--data는 알림 값)
+  --tool <이름>        app trigger: 이벤트 대신 에이전트 도구를 부릅니다(--data는 입력)
   --lang <로케일>      메시지 언어(기본: SAYREN_LANG → 시스템 로케일 → ko)
 
 종료 코드: 0 성공 · 1 실패 · 3 승인 대기(에이전트 토큰)`;
@@ -9180,7 +9200,7 @@ async function selectStore(auth, client, io, candidates, folderStore = null) {
 
 //#endregion
 //#region package.json
-var version = "0.7.0";
+var version = "0.8.1";
 
 //#endregion
 //#region src/client.ts
@@ -9222,14 +9242,16 @@ function detailsOf(error) {
 //#endregion
 //#region src/app-commands.ts
 /**
-* `sayren app …`(이슈 #22, 매뉴얼 「앱 만들기」) — 앱 폴더(`sayren.app.json`)에서 돈다. 서버는 코드를 빌드하지 않는다(A1):
+* `sayren app …`(이슈 #22, 매뉴얼 「앱 만들기」) — 앱 폴더(`manifest.json`)에서 돈다. 서버는 코드를 빌드하지 않는다(A1):
 * CLI가 esbuild로 서버 번들 한 파일을 만들어 올리고 api가 `DEPENDENCIES`·`VERIFY`·`BUNDLE`·`UPLOAD`를 돈다. 앱 화면(`ui/`)은
 * 정적 파일 그대로 올린다.
 *
 * 인증은 둘이다. 앱 배포 키(`--key`·`SAYREN_APP_KEY`, developer.sayren.app에서 발행, `sak_…`)는 그 앱의 경로에만 쓰이고(CI 용도),
 * 그 밖에는 `sayren login`의 계정 토큰이다. 앱 등록(`init`)·개발 상점은 계정 토큰만 된다.
 */
-const APP_MANIFEST_FILE = "sayren.app.json";
+const APP_MANIFEST_FILE = "manifest.json";
+/** 0.8.0까지의 매니페스트 이름 — `manifest.json`이 없을 때만 읽고 경고한다 */
+const LEGACY_APP_MANIFEST_FILE = "sayren.app.json";
 const APP_STATE_FILE = `${STATE_DIR}/app.json`;
 const APP_DEV_PORT = 4020;
 const SERVER_ENTRY_CANDIDATES = [
@@ -9259,10 +9281,17 @@ function writeAppState(dir, state) {
 	mkdirSync(join(dir, STATE_DIR), { recursive: true });
 	writeFileSync(join(dir, APP_STATE_FILE), `${JSON.stringify(state, null, 2)}\n`, { mode: 384 });
 }
-/** 매니페스트 원문(JSON)과 검증 결과 — 문제가 있으면 CliError */
+/** 앱 폴더의 매니페스트 파일 — `manifest.json`, 없으면 옛 이름 `sayren.app.json`. 둘 다 없으면 null */
+function manifestFileOf(dir) {
+	if (existsSync(join(dir, APP_MANIFEST_FILE))) return APP_MANIFEST_FILE;
+	if (existsSync(join(dir, LEGACY_APP_MANIFEST_FILE))) return LEGACY_APP_MANIFEST_FILE;
+	return null;
+}
+/** 매니페스트 원문(JSON)과 검증 결과 — 문제가 있으면 CliError. 옛 이름으로 읽었으면 `warnings`에 이름 변경 안내가 든다 */
 function loadManifest(dir) {
-	const path = join(dir, APP_MANIFEST_FILE);
-	if (!existsSync(path)) throw new CliError(cli_app_manifest_missing({ file: APP_MANIFEST_FILE }));
+	const file = manifestFileOf(dir);
+	if (!file) throw new CliError(cli_app_manifest_missing({ file: APP_MANIFEST_FILE }));
+	const path = join(dir, file);
 	let raw;
 	try {
 		raw = JSON.parse(readFileSync(path, "utf8"));
@@ -9273,9 +9302,11 @@ function loadManifest(dir) {
 	if (!parsed.success) throw new CliError(cli_app_manifest_invalid({ problems: parsed.error.issues.map((issue) => `- ${issue.path.join(".") || "(root)"}: ${issue.message}`).join("\n") }));
 	const problems = appManifestProblems(parsed.data);
 	if (problems.length) throw new CliError(cli_app_manifest_invalid({ problems: problems.map((p) => `- ${p.path}: ${p.message} (${p.code})`).join("\n") }));
+	const warnings = file === LEGACY_APP_MANIFEST_FILE ? [cli_app_manifest_legacy()] : [];
 	return {
 		raw,
-		manifest: parsed.data
+		manifest: parsed.data,
+		warnings
 	};
 }
 function appDir(flags, io) {
@@ -9283,7 +9314,7 @@ function appDir(flags, io) {
 }
 function requireState(dir) {
 	const state = readAppState(dir);
-	if (!state) throw new CliError(cli_app_not_registered({ file: APP_MANIFEST_FILE }));
+	if (!state) throw new CliError(cli_app_not_registered({ file: manifestFileOf(dir) ?? APP_MANIFEST_FILE }));
 	return state;
 }
 /** 배포 키(`--key` → `SAYREN_APP_KEY`)가 있으면 그것, 없으면 계정 토큰(`resolveAuth`) */
@@ -9395,7 +9426,9 @@ async function loadBundle(dir, server) {
 		meta: {
 			events: [...meta.events],
 			http: [...meta.http],
-			schedules: [...meta.schedules ?? []]
+			schedules: [...meta.schedules ?? []],
+			flows: [...meta.flows ?? []],
+			tools: [...meta.tools ?? []]
 		}
 	};
 }
@@ -9436,21 +9469,40 @@ function collectListing(dir, manifest) {
 	};
 }
 /** 로컬 검사 — 매니페스트, 번들, 이벤트 함수 존재, 비밀 값 형식, 크기. 서버 `VERIFY`·`BUNDLE`과 같은 규칙 */
+/**
+* 외부 런타임 앱(매뉴얼 「개발자 서버에서 실행」)이 올리는 서버 자리 — 코드는 개발자 서버에 있어 sayren 실행 환경에는 이것만 둔다(호출되지 않는다)
+*/
+const EXTERNAL_STUB_SERVER = "export default { fetch() { return new Response(\"external runtime\", { status: 404 }); } };\n";
+const EMPTY_META = {
+	events: [],
+	http: [],
+	schedules: [],
+	flows: [],
+	tools: []
+};
 async function verifyApp(dir) {
-	const { raw, manifest } = loadManifest(dir);
-	const server = await bundleServer(dir);
+	const { raw, manifest, warnings } = loadManifest(dir);
+	const external = manifest.runtime === "external";
+	const server = external ? EXTERNAL_STUB_SERVER : await bundleServer(dir);
 	if (APP_SECRET_PATTERNS.find((pattern) => pattern.test(server))) throw new CliError(cli_app_secret_in_source());
 	const gzipBytes = gzipSync(server).byteLength;
 	if (gzipBytes > APP_SERVER_BUNDLE_MAX_GZIP_BYTES) throw new CliError(cli_app_bundle_too_large({ size: formatMb(gzipBytes) }));
-	const { app, meta } = await loadBundle(dir, server);
+	const { app, meta } = external ? {
+		app: {
+			fetch: async () => new Response("external runtime", { status: 404 }),
+			__sayrenApp: EMPTY_META
+		},
+		meta: { ...EMPTY_META }
+	} : await loadBundle(dir, server);
 	const httpKeys = new Set(meta.http.map((key) => key.trim().replace(/\s+/g, " ")));
-	const missing = [
+	const missing = external ? [] : [
 		...manifest.events.filter((event) => !meta.events.includes(event)),
 		...Object.keys(manifest.schedules).filter((name) => !meta.schedules.includes(name)),
+		...Object.keys(manifest.flow?.notifications ?? {}).filter((name) => !meta.flows.includes(name)),
+		...Object.keys(manifest.mcp?.tools ?? {}).filter((name) => !meta.tools.includes(name)),
 		...(manifest.http?.public ?? []).filter((key) => !httpKeys.has(key))
 	];
 	if (missing.length) throw new CliError(cli_app_handler_missing({ events: missing.join(", ") }));
-	const warnings = [];
 	const listed = manifest.events;
 	const extra = meta.events.filter((event) => !listed.includes(event));
 	if (extra.length) warnings.push(cli_app_handler_unlisted({ events: extra.join(", ") }));
@@ -9560,7 +9612,7 @@ export default defineApp({
 async function appInit(handle, flags, io) {
 	if (!handle || !HANDLE_RE.test(handle)) throw new CliError(cli_app_handle_invalid());
 	const dir = resolve(io.cwd, flags.dir ?? handle);
-	if (existsSync(join(dir, APP_MANIFEST_FILE))) throw new CliError(cli_app_dir_exists({ dir: relative(io.cwd, dir) || "." }));
+	if (manifestFileOf(dir)) throw new CliError(cli_app_dir_exists({ dir: relative(io.cwd, dir) || "." }));
 	const name = flags.name?.trim() || handle;
 	const auth = await developerAuth(flags, dir, io, { accountOnly: true });
 	const privateStoreId = flags.privateStore?.trim();
@@ -9825,6 +9877,16 @@ function devEnvelope(input) {
 			role: "OWNER"
 		} } : {},
 		...input.schedule ? { schedule: input.schedule } : {},
+		...input.tool ? { tool: input.tool } : {},
+		...input.flow ? { flow: {
+			orderId: "ord_dev",
+			orderItemIds: ["oi_dev"],
+			flowId: "flow_dev",
+			flowVersion: 1,
+			state: "dev",
+			params: {},
+			...input.flow
+		} } : {},
 		...input.event ? { event: {
 			id: `evt_dev_${devSeq}`,
 			type: input.event.type,
@@ -9876,7 +9938,8 @@ function readBody(req) {
 async function appDev(flags, io) {
 	const dir = appDir(flags, io);
 	const state = requireState(dir);
-	const { manifest } = loadManifest(dir);
+	const { manifest, warnings } = loadManifest(dir);
+	for (const warning of warnings) io.err(cli_app_warning({ message: warning }));
 	const { app } = await loadBundle(dir, await bundleServer(dir));
 	const port = Number(flags.port ?? io.env.SAYREN_APP_PORT ?? APP_DEV_PORT);
 	if (!Number.isInteger(port) || port < 1 || port > 65535) throw new CliError(cli_app_port_invalid({ value: String(flags.port) }));
@@ -9900,6 +9963,47 @@ async function appDev(flags, io) {
 		try {
 			if (req.method === "POST" && url.pathname === "/_trigger") {
 				const body = JSON.parse(await readBody(req) || "{}");
+				if (body.tool) {
+					const { settings: settings$1, secrets: secrets$1 } = local();
+					const result$1 = await invokeLocal(app, devEnvelope({
+						kind: "tool",
+						tool: {
+							name: body.tool,
+							input: body.data ?? {}
+						},
+						publicOrigin,
+						token: await ensureToken(),
+						apiBaseUrl,
+						appId: state.appId,
+						settings: settings$1,
+						secrets: secrets$1
+					}));
+					printResult(`[tool] ${body.tool}`, result$1, io);
+					if (result$1.response?.body) io.out(`  → ${result$1.response.body}`);
+					res.writeHead(200, { "content-type": "application/json" });
+					res.end(JSON.stringify(result$1));
+					return;
+				}
+				if (body.flow) {
+					const { settings: settings$1, secrets: secrets$1 } = local();
+					const result$1 = await invokeLocal(app, devEnvelope({
+						kind: "flow",
+						flow: {
+							...body.data ?? {},
+							name: body.flow
+						},
+						publicOrigin,
+						token: await ensureToken(),
+						apiBaseUrl,
+						appId: state.appId,
+						settings: settings$1,
+						secrets: secrets$1
+					}));
+					printResult(`[flow] ${body.flow}`, result$1, io);
+					res.writeHead(200, { "content-type": "application/json" });
+					res.end(JSON.stringify(result$1));
+					return;
+				}
 				if (body.schedule) {
 					const { settings: settings$1, secrets: secrets$1 } = local();
 					const result$1 = await invokeLocal(app, devEnvelope({
@@ -10019,6 +10123,47 @@ async function appDev(flags, io) {
 }
 async function appTrigger(type, flags, io) {
 	const port = Number(flags.port ?? io.env.SAYREN_APP_PORT ?? APP_DEV_PORT);
+	if (flags.tool) {
+		let toolInput = {};
+		if (flags.data) try {
+			toolInput = JSON.parse(flags.data);
+		} catch {
+			throw new CliError(cli_app_trigger_data_invalid());
+		}
+		const res$1 = await io.fetch(`http://127.0.0.1:${port}/_trigger`, {
+			method: "POST",
+			headers: { "content-type": "application/json" },
+			body: JSON.stringify({
+				tool: flags.tool,
+				data: toolInput
+			})
+		});
+		if (!res$1.ok) throw new CliError(cli_app_trigger_failed({ status: String(res$1.status) }));
+		const result$1 = await res$1.json();
+		printResult(`[tool] ${flags.tool}`, result$1, io);
+		if (result$1.response?.body) io.out(`  → ${result$1.response.body}`);
+		return result$1.outcome === "OK" ? 0 : 1;
+	}
+	if (flags.flow) {
+		let flowData = {};
+		if (flags.data) try {
+			flowData = JSON.parse(flags.data);
+		} catch {
+			throw new CliError(cli_app_trigger_data_invalid());
+		}
+		const res$1 = await io.fetch(`http://127.0.0.1:${port}/_trigger`, {
+			method: "POST",
+			headers: { "content-type": "application/json" },
+			body: JSON.stringify({
+				flow: flags.flow,
+				data: flowData
+			})
+		});
+		if (!res$1.ok) throw new CliError(cli_app_trigger_failed({ status: String(res$1.status) }));
+		const result$1 = await res$1.json();
+		printResult(`[flow] ${flags.flow}`, result$1, io);
+		return result$1.outcome === "OK" ? 0 : 1;
+	}
 	if (flags.schedule) {
 		const res$1 = await io.fetch(`http://127.0.0.1:${port}/_trigger`, {
 			method: "POST",
@@ -11954,7 +12099,9 @@ const VALUE_FLAGS = new Set([
 	"data",
 	"order",
 	"schedule",
-	"private-store"
+	"private-store",
+	"flow",
+	"tool"
 ]);
 const BOOL_FLAGS = new Set([
 	"force",
@@ -12041,6 +12188,8 @@ async function main(argv, io) {
 			order: str(parsed.flags.order),
 			schedule: str(parsed.flags.schedule),
 			privateStore: str(parsed.flags["private-store"]),
+			flow: str(parsed.flags.flow),
+			tool: str(parsed.flags.tool),
 			yes: parsed.flags.yes === true
 		}, io);
 		case "init": return init({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sayren",
-  "version": "0.7.0",
+  "version": "0.8.1",
   "type": "module",
   "description": "sayren CLI — 호스팅 스토어프론트(init·pull·deploy)와 서드파티 앱(app init·dev·deploy·release)",
   "bin": {
@@ -14,7 +14,7 @@
   },
   "dependencies": {
     "esbuild": "^0.28.2",
-    "@sayren/store-sdk": "^0.30.12"
+    "@sayren/store-sdk": "^0.30.13"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.5.14",