@rivus/gateway 0.16.2 → 0.17.0

package/templates/acp-stdio-proxy.mjs

@@ -6,10 +6,12 @@ import {
   createAcpStdioAgentLoop,
   createJsonAcpSessionStore,
   serveAcpAgentOnStdio
-} from "@rivus/agent/acp";
+} from "@rivus/runtime/acp";
 
 const command = process.env.RIVUS_ACP_SERVER_COMMAND?.trim();
-if (!command) throw new Error("RIVUS_ACP_SERVER_COMMAND is required and must resolve to an explicit executable");
+if (!command) {
+  throw new Error("RIVUS_ACP_SERVER_COMMAND is required and must resolve to an explicit executable");
+}
 
 const workingDirectory = process.env.RIVUS_ACP_WORKING_DIRECTORY?.trim() || process.cwd();
 const sessionStorePath = process.env.RIVUS_ACP_SESSION_STORE?.trim();
@@ -37,7 +39,9 @@ try {
 }
 
 function parseArguments(value) {
-  if (!value?.trim()) return [];
+  if (!value?.trim()) {
+    return [];
+  }
   const parsed = JSON.parse(value);
   if (!Array.isArray(parsed) || parsed.some((item) => typeof item !== "string")) {
     throw new Error("RIVUS_ACP_SERVER_ARGUMENTS must be a JSON array of strings");
@@ -52,7 +56,9 @@ function selectEnvironment(value) {
     .map((item) => item.trim())
     .filter(Boolean) ?? []) {
     const environmentValue = process.env[key];
-    if (environmentValue !== undefined) selected[key] = environmentValue;
+    if (environmentValue !== undefined) {
+      selected[key] = environmentValue;
+    }
   }
   return selected;
 }

package/templates/current-weather.mjs

@@ -85,12 +85,16 @@ async function fetchJson(url, operation) {
 }
 
 function readNumber(value, field) {
-  if (typeof value !== "number" || !Number.isFinite(value)) throw new Error(`current-weather missing ${field}`);
+  if (typeof value !== "number" || !Number.isFinite(value)) {
+    throw new Error(`current-weather missing ${field}`);
+  }
   return value;
 }
 
 function readString(value, field) {
-  if (typeof value !== "string" || !value) throw new Error(`current-weather missing ${field}`);
+  if (typeof value !== "string" || !value) {
+    throw new Error(`current-weather missing ${field}`);
+  }
   return value;
 }
 
@@ -103,15 +107,35 @@ function readFirstNumber(value, field) {
 }
 
 function describeWeatherCode(code) {
-  if (code === 0) return "晴";
-  if (code === 1 || code === 2) return "晴间多云";
-  if (code === 3) return "阴";
-  if (code === 45 || code === 48) return "有雾";
-  if (code >= 51 && code <= 57) return "毛毛雨";
-  if (code >= 61 && code <= 67) return "雨";
-  if (code >= 71 && code <= 77) return "雪";
-  if (code >= 80 && code <= 82) return "阵雨";
-  if (code >= 85 && code <= 86) return "阵雪";
-  if (code >= 95 && code <= 99) return "雷暴";
+  if (code === 0) {
+    return "晴";
+  }
+  if (code === 1 || code === 2) {
+    return "晴间多云";
+  }
+  if (code === 3) {
+    return "阴";
+  }
+  if (code === 45 || code === 48) {
+    return "有雾";
+  }
+  if (code >= 51 && code <= 57) {
+    return "毛毛雨";
+  }
+  if (code >= 61 && code <= 67) {
+    return "雨";
+  }
+  if (code >= 71 && code <= 77) {
+    return "雪";
+  }
+  if (code >= 80 && code <= 82) {
+    return "阵雨";
+  }
+  if (code >= 85 && code <= 86) {
+    return "阵雪";
+  }
+  if (code >= 95 && code <= 99) {
+    return "雷暴";
+  }
   return "未知";
 }

package/templates/herdr-feishu.mjs

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+
+import { readFile } from "node:fs/promises";
+import { checkHerdrFeishuBridge, startHerdrFeishuBridge } from "@rivus/gateway/bootstrap/herdr-feishu";
+
+if (process.argv.slice(2).some((arg) => arg !== "--check")) {
+  throw new Error("Usage: herdr-feishu.mjs [--check]");
+}
+const path = process.env.RIVUS_HERDR_CONFIG;
+if (!path) {
+  throw new Error("Set RIVUS_HERDR_CONFIG to a private bridge configuration file");
+}
+const config = JSON.parse(await readFile(path, "utf8"));
+const options = {
+  ...config,
+  appId: process.env.FEISHU_APP_ID,
+  appSecret: process.env.FEISHU_APP_SECRET,
+  onObservation: (event) => process.stdout.write(`${JSON.stringify(event)}\n`)
+};
+if (process.argv.includes("--check")) {
+  process.stdout.write(`${JSON.stringify(await checkHerdrFeishuBridge(options), null, 2)}\n`);
+} else {
+  const bridge = await startHerdrFeishuBridge(options);
+  process.stdout.write("Herdr bridge started; verify receipt and reply before treating the transport as ready.\n");
+  for (const signal of ["SIGINT", "SIGTERM"]) {
+    process.once(signal, async () => {
+      await bridge.stop();
+    });
+  }
+}

package/templates/html-drive-tools.mjs

@@ -25,7 +25,9 @@ export function createHtmlArtifactWriter(options = {}) {
       try {
         await writeFile(filePath, html, { encoding: "utf8", flag: "wx" });
       } catch (error) {
-        if (!isFileAlreadyPresent(error) || (await readFile(filePath, "utf8")) !== html) throw error;
+        if (!isFileAlreadyPresent(error) || (await readFile(filePath, "utf8")) !== html) {
+          throw error;
+        }
       }
       return Object.freeze({
         artifactId,
@@ -85,15 +87,21 @@ export function createLarkDriveHtmlUploader(options = {}) {
 
 async function readRegularFileNoFollow(filePath, artifactId) {
   const linkMetadata = await lstat(filePath);
-  if (linkMetadata.isSymbolicLink()) throw new Error(`HTML artifact cannot be a symbolic link: ${artifactId}`);
+  if (linkMetadata.isSymbolicLink()) {
+    throw new Error(`HTML artifact cannot be a symbolic link: ${artifactId}`);
+  }
   if (typeof constants.O_NOFOLLOW !== "number") {
     throw new Error("HTML artifact upload requires filesystem no-follow support");
   }
   const handle = await open(filePath, constants.O_RDONLY | constants.O_NOFOLLOW);
   try {
     const metadata = await handle.stat();
-    if (!metadata.isFile()) throw new Error(`HTML artifact is not a regular file: ${artifactId}`);
-    if (metadata.size > 256 * 1024) throw new Error(`HTML artifact exceeds the 256 KiB limit: ${artifactId}`);
+    if (!metadata.isFile()) {
+      throw new Error(`HTML artifact is not a regular file: ${artifactId}`);
+    }
+    if (metadata.size > 256 * 1024) {
+      throw new Error(`HTML artifact exceeds the 256 KiB limit: ${artifactId}`);
+    }
     return await handle.readFile();
   } finally {
     await handle.close();
@@ -138,7 +146,9 @@ function readCompleteHtml(input) {
   if (!/^<!doctype html>/i.test(html) || !/<html(?:\s|>)/i.test(html) || !/<\/html>\s*$/i.test(html)) {
     throw new Error("write-html-artifact requires a complete HTML document");
   }
-  if (Buffer.byteLength(html) > 256 * 1024) throw new Error("HTML artifact exceeds the 256 KiB limit");
+  if (Buffer.byteLength(html) > 256 * 1024) {
+    throw new Error("HTML artifact exceeds the 256 KiB limit");
+  }
   return html;
 }
 
@@ -165,18 +175,24 @@ function readUploadResult(stdout, requestedName) {
     throw new Error("lark-cli upload returned invalid JSON");
   }
   const result = isRecord(parsed?.data) ? parsed.data : parsed;
-  if (!isRecord(result)) throw new Error("lark-cli upload returned an invalid result");
+  if (!isRecord(result)) {
+    throw new Error("lark-cli upload returned an invalid result");
+  }
   const fileToken = readFirstString(result, ["file_token", "fileToken", "token"]);
   const url = readFirstString(result, ["url", "web_url", "file_url"]);
   const name = readFirstString(result, ["name", "file_name"]) ?? requestedName;
-  if (!fileToken || !url) throw new Error("lark-cli upload result is missing file token or URL");
+  if (!fileToken || !url) {
+    throw new Error("lark-cli upload result is missing file token or URL");
+  }
   return Object.freeze({ fileToken, name, url });
 }
 
 function readFirstString(value, keys) {
   for (const key of keys) {
     const candidate = value[key];
-    if (typeof candidate === "string" && candidate.trim()) return candidate.trim();
+    if (typeof candidate === "string" && candidate.trim()) {
+      return candidate.trim();
+    }
   }
   return undefined;
 }
@@ -191,7 +207,9 @@ function resolveArtifactRoot(cwd, artifactRoot = DEFAULT_ARTIFACT_ROOT) {
 }
 
 function resolveAgentDirectory(artifactRoot, agentId) {
-  if (typeof agentId !== "string" || !agentId.trim()) throw new Error("HTML artifact tool requires an agent id");
+  if (typeof agentId !== "string" || !agentId.trim()) {
+    throw new Error("HTML artifact tool requires an agent id");
+  }
   return resolve(artifactRoot, createHash("sha256").update(agentId).digest("hex").slice(0, 16));
 }
 
@@ -218,7 +236,9 @@ async function resolveTrustedDirectory(cwd, directory, create) {
     if (metadata.isSymbolicLink()) {
       throw new Error("HTML artifact directory cannot contain symbolic links");
     }
-    if (!metadata.isDirectory()) throw new Error("HTML artifact path component is not a directory");
+    if (!metadata.isDirectory()) {
+      throw new Error("HTML artifact path component is not a directory");
+    }
   }
   const [workspacePath, directoryPath] = await Promise.all([realpath(lexicalWorkspace), realpath(lexicalDirectory)]);
   const resolvedRelativePath = relative(workspacePath, directoryPath);
@@ -232,12 +252,16 @@ async function readOrCreateDirectory(directory, create) {
   try {
     return await lstat(directory);
   } catch (error) {
-    if (!isMissingFile(error) || !create) throw error;
+    if (!isMissingFile(error) || !create) {
+      throw error;
+    }
   }
   try {
     await mkdir(directory);
   } catch (error) {
-    if (!isFileAlreadyPresent(error)) throw error;
+    if (!isFileAlreadyPresent(error)) {
+      throw error;
+    }
   }
   return lstat(directory);
 }

package/templates/pi-feishu-deployment.bootstrap.ts

@@ -1,3 +1 @@
-// Projects initialized by Gateway keep the historical bootstrap specifier while
-// the implementation remains in the Gateway package canonical owner.
-export { createRivusDeploymentAdapters } from "@rivus/agent/bootstrap/pi-feishu";
+export { createRivusDeploymentAdapters } from "@rivus/gateway/bootstrap/pi-feishu";

package/templates/pi-feishu.bootstrap.ts

@@ -1,242 +1 @@
-import { mkdir } from "node:fs/promises";
-import { homedir } from "node:os";
-import { Effect } from "effect";
-import * as Lark from "@larksuiteoapi/node-sdk";
-import { createAgentSession, ModelRuntime, SessionManager } from "@earendil-works/pi-coding-agent";
-import {
-  createJsonFetchRequest,
-  createJsonFileFeishuCardTargetRegistry,
-  createJsonlAgentEventLog,
-  createLazyFeishuWebSocketEventDispatcher,
-  mergePiProviderBaseUrlOverride,
-  createRivusDaemonStatusHttpServer,
-  createPiAgentLoop,
-  createPiSessionRegistry,
-  createSystemClock,
-  createUuidRunIds,
-  restoreConfiguredRivusDaemonBootstrap,
-  type ConfiguredRivusDaemonBootstrapRequest,
-  type ConfiguredRivusDaemonBootstrapResponse,
-  type FeishuWebSocketClient,
-  type RivusDaemonBootstrapContext,
-  type RivusDaemonFeishuReplayRunner,
-  type RivusDaemonProcess,
-  type RivusDaemonPromptRunner,
-  type RivusDaemonStatusReporter,
-  type FeishuReceiveMessagePayload,
-  type FeishuReceiveMessageReplayOptions
-} from "@rivus/agent";
-import {
-  createPiSkillReadTools,
-  createPiSessionResources,
-  resolvePiSessionToolNames,
-  validatePiSkillCommand
-} from "@rivus/agent/pi";
-
-type PiSessionOptions = NonNullable<Parameters<typeof createAgentSession>[0]>;
-
-const STATE_DIR = "./.rivus";
-const CARD_TARGETS_FILE = `${STATE_DIR}/feishu-card-targets.json`;
-const EVENT_LOG_FILE = `${STATE_DIR}/agent-events.jsonl`;
-const PI_AUTH_FILE = `${STATE_DIR}/pi-auth.json`;
-const PI_MODELS_FILE = `${STATE_DIR}/pi-models.json`;
-const PI_AGENT_DIR = `${STATE_DIR}/pi-agent`;
-
-export async function createRivusDaemonProcess(
-  context: RivusDaemonBootstrapContext
-): Promise<RivusDaemonProcess & RivusDaemonPromptRunner & RivusDaemonStatusReporter & RivusDaemonFeishuReplayRunner> {
-  await mkdir(PI_AGENT_DIR, { recursive: true });
-
-  const piSessionOptions = await createPiSessionOptions(context);
-  const sessionRegistry = createPiSessionRegistry({
-    createSession: async () => {
-      const cwd = process.cwd();
-      const resources = await createPiSessionResources({
-        agentDir: PI_AGENT_DIR,
-        cwd,
-        homeDirectory: homedir()
-      });
-      const customTools = createPiSkillReadTools({
-        cwd,
-        runtimeToolIds: [],
-        skillPaths: resources.skillNames.size > 0 ? resources.skillPaths : []
-      });
-      const result = await createAgentSession(
-        resources.withSessionOptions({
-          ...piSessionOptions,
-          customTools,
-          excludeTools: [],
-          sessionManager: SessionManager.create(cwd),
-          tools: [...resolvePiSessionToolNames([], customTools)]
-        })
-      );
-      return {
-        dispose: () => result.session.dispose(),
-        preparePrompt: (input) => {
-          validatePiSkillCommand(input.text, resources.skillNames);
-          return input.text;
-        },
-        session: result.session
-      };
-    }
-  });
-  const piLoop = createPiAgentLoop({
-    supportsSteering: true,
-    disposeSessionAfterRun: false,
-    resolveSession: (input) => sessionRegistry.resolve(input)
-  });
-  const statusPort = readOptionalPort(context.env.RIVUS_STATUS_PORT);
-  const request = createJsonFetchRequest();
-
-  const bootstrap = await Effect.runPromise(
-    restoreConfiguredRivusDaemonBootstrap({
-      cardTargets: createJsonFileFeishuCardTargetRegistry({
-        filePath: CARD_TARGETS_FILE
-      }),
-      clock: createSystemClock(),
-      config: context.config,
-      ...(statusPort === undefined
-        ? {}
-        : {
-            createStatusTransport: (statusReporter: RivusDaemonStatusReporter) =>
-              createRivusDaemonStatusHttpServer({
-                port: statusPort,
-                statusReporter
-              })
-          }),
-      eventDispatcher: createLazyFeishuWebSocketEventDispatcher(() => new Lark.EventDispatcher({})),
-      eventLog: createJsonlAgentEventLog({
-        filePath: EVENT_LOG_FILE
-      }),
-      loop: piLoop,
-      request: (input: ConfiguredRivusDaemonBootstrapRequest) =>
-        request(input).pipe(Effect.map((response) => response as ConfiguredRivusDaemonBootstrapResponse)),
-      runIds: createUuidRunIds(),
-      sleep: (ms) => Effect.promise(() => new Promise<void>((resolve) => setTimeout(resolve, ms))),
-      websocketClient: createLazyFeishuWebSocketClient({
-        appId: context.config.feishu.appId,
-        appSecret: context.config.feishu.appSecret
-      })
-    })
-  );
-
-  return {
-    promptText: (command) => bootstrap.promptText(command),
-    replayReceiveMessage: (payload: FeishuReceiveMessagePayload, options?: FeishuReceiveMessageReplayOptions) =>
-      bootstrap.runtime.replayReceiveMessage(payload, options),
-    running: () => bootstrap.process.running(),
-    start: () => bootstrap.process.start(),
-    status: () => bootstrap.status(),
-    stop: () =>
-      Effect.gen(function* () {
-        yield* bootstrap.process.stop();
-        yield* Effect.tryPromise({
-          try: () => sessionRegistry.disposeAll(),
-          catch: (error) => error
-        });
-      })
-  };
-}
-
-function createLazyFeishuWebSocketClient(options: {
-  readonly appId: string;
-  readonly appSecret: string;
-}): FeishuWebSocketClient {
-  let client:
-    | {
-        close(): void;
-        start(options: Parameters<FeishuWebSocketClient["start"]>[0]): Promise<void> | void;
-      }
-    | undefined;
-
-  return {
-    start: (startOptions) => {
-      client ??= new Lark.WSClient({
-        appId: options.appId,
-        appSecret: options.appSecret
-      });
-      return client.start(startOptions);
-    },
-    close: () => {
-      client?.close();
-      client = undefined;
-    }
-  };
-}
-
-async function createPiSessionOptions(context: RivusDaemonBootstrapContext): Promise<PiSessionOptions> {
-  const provider = readProviderFromModel(context.config.pi.model);
-
-  if (context.config.pi.baseUrl) {
-    if (!provider) {
-      throw new Error("PI_BASE_URL requires PI_MODEL in provider/model form, for example zai/glm-5.2");
-    }
-    await writeProviderBaseUrlOverride(provider, context.config.pi.baseUrl);
-  }
-
-  const modelRuntime = await ModelRuntime.create({
-    allowModelNetwork: false,
-    authPath: PI_AUTH_FILE,
-    modelsPath: context.config.pi.baseUrl ? PI_MODELS_FILE : null
-  });
-  if (context.config.pi.apiKey) {
-    if (!provider) {
-      throw new Error("PI_API_KEY requires PI_MODEL in provider/model form, for example zai/glm-5.2");
-    }
-    await modelRuntime.setRuntimeApiKey(provider, context.config.pi.apiKey);
-  }
-  const model = context.config.pi.model ? resolveConfiguredPiModel(modelRuntime, context.config.pi.model) : undefined;
-  return {
-    cwd: process.cwd(),
-    modelRuntime,
-    ...(model ? { model } : {}),
-    ...(context.config.pi.thinkingLevel ? { thinkingLevel: context.config.pi.thinkingLevel } : {})
-  };
-}
-
-function resolveConfiguredPiModel(modelRuntime: ModelRuntime, modelReference: string): PiSessionOptions["model"] {
-  const provider = readProviderFromModel(modelReference);
-  const modelId = readModelIdFromModel(modelReference);
-  if (!provider || !modelId) {
-    throw new Error("PI_MODEL must use provider/model form, for example zai/glm-5.2");
-  }
-
-  const model = modelRuntime.getModel(provider, modelId);
-  if (!model) {
-    throw new Error(`PI_MODEL ${modelReference} was not found in the Pi model runtime`);
-  }
-  return model as PiSessionOptions["model"];
-}
-
-function readProviderFromModel(model: string | undefined): string | undefined {
-  const slashIndex = model?.indexOf("/") ?? -1;
-  if (!model || slashIndex <= 0) {
-    return undefined;
-  }
-  return model.slice(0, slashIndex);
-}
-
-function readModelIdFromModel(model: string | undefined): string | undefined {
-  const slashIndex = model?.indexOf("/") ?? -1;
-  if (!model || slashIndex < 0 || slashIndex === model.length - 1) {
-    return undefined;
-  }
-  return model.slice(slashIndex + 1);
-}
-
-function readOptionalPort(value: string | undefined): number | undefined {
-  const trimmed = value?.trim();
-  if (!trimmed) {
-    return undefined;
-  }
-
-  const port = Number(trimmed);
-  if (!Number.isInteger(port) || port < 0 || port > 65_535) {
-    throw new Error("RIVUS_STATUS_PORT must be an integer between 0 and 65535");
-  }
-  return port;
-}
-
-async function writeProviderBaseUrlOverride(provider: string, baseUrl: string): Promise<void> {
-  await mergePiProviderBaseUrlOverride({ baseUrl, filePath: PI_MODELS_FILE, provider });
-}
+export { createRivusDaemonProcess } from "@rivus/gateway/bootstrap/pi-feishu";

package/templates/rivus-agents.plugin.mjs

@@ -281,7 +281,9 @@ async function saveNote(input, context) {
   try {
     await writeFile(filePath, content, { encoding: "utf8", flag: "wx" });
   } catch (error) {
-    if (!(error instanceof Error) || !("code" in error) || error.code !== "EEXIST") throw error;
+    if (!(error instanceof Error) || !("code" in error) || error.code !== "EEXIST") {
+      throw error;
+    }
     if ((await readFile(filePath, "utf8")) !== content) {
       throw new Error("operation id is already bound to different note content");
     }

package/dist/chunks/background-session-control-input.js

@@ -1,45 +0,0 @@
-//#region src/core/application/background-session/control/background-session-control-input.ts
-function readBackgroundSessionObject(input, allowed, error) {
-	if (input === null || typeof input !== "object" || Array.isArray(input)) throw error("background tool input must be an object");
-	const record = input;
-	const unknown = Object.keys(record).find((key) => !allowed.includes(key));
-	if (unknown) throw error(`field is not allowed: ${unknown}`);
-	return record;
-}
-function readBackgroundSessionString(value, name, error) {
-	if (typeof value !== "string" || value.trim() === "") throw error(`${name} must be a non-empty string`);
-	return value;
-}
-function readBackgroundSessionInteger(value, name, error) {
-	if (!Number.isSafeInteger(value) || value < 1) throw error(`${name} must be a positive integer`);
-	return value;
-}
-function readBackgroundSessionPhase(value, error) {
-	const phases = [
-		"queued",
-		"running",
-		"waiting",
-		"input-required",
-		"stopping",
-		"stopped",
-		"completed",
-		"failed",
-		"reconciliation-required"
-	];
-	if (typeof value !== "string" || !phases.includes(value)) throw error(`phase must be one of ${phases.join(", ")}`);
-	return value;
-}
-function readBackgroundSessionWaitInput(input, error) {
-	const { delayMs, reason, until } = readBackgroundSessionObject(input, [
-		"delayMs",
-		"reason",
-		"until"
-	], error);
-	const args = {};
-	if (delayMs !== void 0) args.delayMs = readBackgroundSessionInteger(delayMs, "delayMs", error);
-	if (reason !== void 0) args.reason = readBackgroundSessionString(reason, "reason", error);
-	if (until !== void 0) args.until = readBackgroundSessionString(until, "until", error);
-	return args;
-}
-//#endregion
-export { readBackgroundSessionWaitInput as a, readBackgroundSessionString as i, readBackgroundSessionObject as n, readBackgroundSessionPhase as r, readBackgroundSessionInteger as t };