@delexec/ops 0.1.0

package/README.md

@@ -0,0 +1,3 @@
+# @delexec/ops
+
+Unified operator CLI for delegated execution clients.

package/README.zh-CN.md

@@ -0,0 +1,6 @@
+# @delexec/ops
+
+> 英文版：README.md
+> 说明：中文文档为准。
+
+面向委托执行客户端的统一运维 CLI。

package/node_modules/@delexec/caller-controller/README.md

@@ -0,0 +1,3 @@
+# @delexec/caller-controller
+
+Caller controller service for delegated execution clients.

package/node_modules/@delexec/caller-controller/README.zh-CN.md

@@ -0,0 +1,6 @@
+# @delexec/caller-controller
+
+> 英文版：README.md
+> 说明：中文文档为准。
+
+委托执行客户端的 caller 控制器服务。

package/node_modules/@delexec/caller-controller/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@delexec/caller-controller",
+  "version": "0.1.0",
+  "description": "Caller controller service for delegated execution clients",
+  "type": "module",
+  "bin": {
+    "delexec-caller-controller": "src/server.js",
+    "croc-caller-controller": "src/server.js"
+  },
+  "bundleDependencies": [
+    "@delexec/caller-controller-core",
+    "@delexec/runtime-utils",
+    "@delexec/sqlite-store",
+    "@delexec/transport-email",
+    "@delexec/transport-emailengine",
+    "@delexec/transport-gmail",
+    "@delexec/transport-relay-http"
+  ],
+  "main": "src/server.js",
+  "exports": {
+    ".": "./src/server.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src",
+    "README.md"
+  ],
+  "scripts": {
+    "prepack": "node ../../scripts/bundle-workspace-deps.mjs stage apps/caller-controller",
+    "postpack": "node ../../scripts/bundle-workspace-deps.mjs cleanup apps/caller-controller",
+    "start": "node src/server.js",
+    "dev": "node --watch src/server.js"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "delegated-execution",
+    "caller",
+    "controller"
+  ],
+  "dependencies": {
+    "@delexec/caller-controller-core": "0.1.0",
+    "@delexec/contracts": "^0.1.0",
+    "@delexec/runtime-utils": "0.1.0",
+    "@delexec/sqlite-store": "0.1.0",
+    "@delexec/transport-email": "0.1.0",
+    "@delexec/transport-emailengine": "0.1.0",
+    "@delexec/transport-gmail": "0.1.0",
+    "@delexec/transport-relay-http": "0.1.0",
+    "better-sqlite3": "^12.6.2"
+  }
+}

package/node_modules/@delexec/caller-controller/src/server.js

@@ -0,0 +1,127 @@
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+import { createCallerControllerServer, createCallerState, hydrateCallerState, serializeCallerState } from "@delexec/caller-controller-core";
+import { createSqliteSnapshotStore } from "@delexec/sqlite-store";
+import { createEmailEngineTransportAdapter } from "@delexec/transport-emailengine";
+import { createGmailTransportAdapter } from "@delexec/transport-gmail";
+import { createRelayHttpTransportAdapter } from "@delexec/transport-relay-http";
+import { buildOpsEnvSearchPaths, loadEnvFiles } from "@delexec/runtime-utils";
+
+export * from "@delexec/caller-controller-core";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const ROOT_DIR = path.resolve(__dirname, "../../..");
+
+loadEnvFiles(buildOpsEnvSearchPaths(ROOT_DIR, "caller"));
+
+function isDirectRun() {
+  if (!process.argv[1]) {
+    return false;
+  }
+  return fs.realpathSync.native(path.resolve(process.argv[1])) === fs.realpathSync.native(__filename);
+}
+
+function loadPlatformConfigFromEnv() {
+  if (String(process.env.PLATFORM_ENABLED || "true") !== "true") {
+    return null;
+  }
+  const baseUrl = process.env.PLATFORM_API_BASE_URL || null;
+  if (!baseUrl) {
+    return null;
+  }
+
+  return {
+    baseUrl,
+    apiKey: process.env.CALLER_PLATFORM_API_KEY || process.env.PLATFORM_API_KEY || null
+  };
+}
+
+function loadTransportConfigFromEnv(serviceName) {
+  const transportType = process.env.TRANSPORT_TYPE || (process.env.TRANSPORT_BASE_URL ? "relay_http" : null);
+  if (transportType === "email") {
+    const provider = process.env.TRANSPORT_EMAIL_PROVIDER || process.env.TRANSPORT_PROVIDER || "unknown";
+    if (provider === "emailengine") {
+      return createEmailEngineTransportAdapter({
+        baseUrl: process.env.TRANSPORT_EMAILENGINE_BASE_URL,
+        account: process.env.TRANSPORT_EMAILENGINE_ACCOUNT,
+        accessToken: process.env.TRANSPORT_EMAILENGINE_ACCESS_TOKEN,
+        sender: process.env.TRANSPORT_EMAIL_SENDER || process.env.CALLER_CONTACT_EMAIL || null,
+        receiver: process.env.TRANSPORT_EMAIL_RECEIVER || null
+      });
+    }
+    if (provider === "gmail") {
+      return createGmailTransportAdapter({
+        clientId: process.env.TRANSPORT_GMAIL_CLIENT_ID,
+        clientSecret: process.env.TRANSPORT_GMAIL_CLIENT_SECRET,
+        refreshToken: process.env.TRANSPORT_GMAIL_REFRESH_TOKEN,
+        user: process.env.TRANSPORT_GMAIL_USER,
+        sender: process.env.TRANSPORT_EMAIL_SENDER || process.env.TRANSPORT_GMAIL_USER || null,
+        receiver: process.env.TRANSPORT_EMAIL_RECEIVER || null
+      });
+    }
+    throw new Error(`TRANSPORT_NOT_IMPLEMENTED: email transport provider ${provider} is not implemented yet`);
+  }
+  const baseUrl = process.env.TRANSPORT_BASE_URL || null;
+  if (!baseUrl || !transportType) {
+    return null;
+  }
+
+  return createRelayHttpTransportAdapter({
+    baseUrl,
+    receiver: process.env.TRANSPORT_RECEIVER || serviceName
+  });
+}
+
+async function createOptionalPersistence(serviceName) {
+  const sqlitePath = process.env.SQLITE_DATABASE_PATH || null;
+  if (!sqlitePath) {
+    return null;
+  }
+
+  const store = await createSqliteSnapshotStore({
+    databasePath: sqlitePath,
+    serviceName
+  });
+  await store.migrate();
+  return store;
+}
+
+if (isDirectRun()) {
+  const port = Number(process.env.PORT || 8081);
+  const serviceName = process.env.SERVICE_NAME || "caller-controller";
+  const state = createCallerState();
+  const transport = loadTransportConfigFromEnv(serviceName);
+  const persistence = await createOptionalPersistence(serviceName);
+  if (persistence) {
+    hydrateCallerState(state, await persistence.loadSnapshot());
+  }
+  const server = createCallerControllerServer({
+    serviceName,
+    state,
+    transport,
+    platform: loadPlatformConfigFromEnv(),
+    background: {
+      enabled: Boolean(transport),
+      receiver: process.env.TRANSPORT_RECEIVER || serviceName,
+      inboxPollIntervalMs: Number(process.env.CALLER_CONTROLLER_INBOX_POLL_INTERVAL_MS || 250),
+      eventsSyncIntervalMs: Number(process.env.CALLER_CONTROLLER_EVENTS_SYNC_INTERVAL_MS || 250)
+    },
+    onStateChanged: persistence
+      ? async (currentState) => {
+          await persistence.saveSnapshot(serializeCallerState(currentState));
+        }
+      : null
+  });
+  server.listen(port, "0.0.0.0", () => {
+    console.log(`[${serviceName}] listening on ${port}`);
+  });
+  server.on("close", () => {
+    if (persistence) {
+      void persistence.saveSnapshot(serializeCallerState(state));
+      void persistence.close();
+    }
+  });
+}

package/node_modules/@delexec/caller-controller-core/README.md

@@ -0,0 +1,3 @@
+# @delexec/caller-controller-core
+
+Core caller-side logic for delegated execution clients.

package/node_modules/@delexec/caller-controller-core/README.zh-CN.md

@@ -0,0 +1,6 @@
+# @delexec/caller-controller-core
+
+> 英文版：README.md
+> 说明：中文文档为准。
+
+委托执行客户端的 caller 侧核心逻辑。

package/node_modules/@delexec/caller-controller-core/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@delexec/caller-controller-core",
+  "version": "0.1.0",
+  "description": "Caller controller core logic for delegated execution",
+  "type": "module",
+  "main": "src/index.js",
+  "exports": {
+    ".": "./src/index.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "delegated-execution",
+    "caller",
+    "core"
+  ],
+  "dependencies": {
+    "@delexec/contracts": "^0.1.0"
+  }
+}