teleton 0.5.1 → 0.6.0

package/dist/chunk-2QUJLHCZ.js

@@ -0,0 +1,362 @@
+import {
+  ConfigSchema,
+  expandPath
+} from "./chunk-4IPJ25HE.js";
+
+// src/config/configurable-keys.ts
+import { readFileSync, writeFileSync, existsSync, chmodSync } from "fs";
+import { parse, stringify } from "yaml";
+var noValidation = () => void 0;
+var identity = (v) => v;
+var nonEmpty = (v) => v.length > 0 ? void 0 : "Must not be empty";
+function numberInRange(min, max) {
+  return (v) => {
+    const n = Number(v);
+    if (isNaN(n)) return "Must be a number";
+    if (n < min || n > max) return `Must be between ${min} and ${max}`;
+    return void 0;
+  };
+}
+function enumValidator(options) {
+  return (v) => options.includes(v) ? void 0 : `Must be one of: ${options.join(", ")}`;
+}
+var CONFIGURABLE_KEYS = {
+  // ─── API Keys ──────────────────────────────────────────────────────
+  "agent.api_key": {
+    type: "string",
+    category: "API Keys",
+    description: "LLM provider API key",
+    sensitive: true,
+    validate: (v) => v.length >= 10 ? void 0 : "Must be at least 10 characters",
+    mask: (v) => v.slice(0, 8) + "****",
+    parse: identity
+  },
+  tavily_api_key: {
+    type: "string",
+    category: "API Keys",
+    description: "Tavily API key for web search",
+    sensitive: true,
+    validate: (v) => v.startsWith("tvly-") ? void 0 : "Must start with 'tvly-'",
+    mask: (v) => v.slice(0, 9) + "****",
+    parse: identity
+  },
+  tonapi_key: {
+    type: "string",
+    category: "API Keys",
+    description: "TonAPI key for higher rate limits",
+    sensitive: true,
+    validate: (v) => v.length >= 10 ? void 0 : "Must be at least 10 characters",
+    mask: (v) => v.slice(0, 10) + "****",
+    parse: identity
+  },
+  "telegram.bot_token": {
+    type: "string",
+    category: "API Keys",
+    description: "Bot token from @BotFather",
+    sensitive: true,
+    validate: (v) => v.includes(":") ? void 0 : "Must contain ':' (e.g., 123456:ABC...)",
+    mask: (v) => v.split(":")[0] + ":****",
+    parse: identity
+  },
+  // ─── Agent ─────────────────────────────────────────────────────────
+  "agent.provider": {
+    type: "enum",
+    category: "Agent",
+    description: "LLM provider",
+    sensitive: false,
+    options: ["anthropic", "openai", "google", "xai", "groq", "openrouter"],
+    validate: enumValidator(["anthropic", "openai", "google", "xai", "groq", "openrouter"]),
+    mask: identity,
+    parse: identity
+  },
+  "agent.model": {
+    type: "string",
+    category: "Agent",
+    description: "Main LLM model ID",
+    sensitive: false,
+    validate: nonEmpty,
+    mask: identity,
+    parse: identity
+  },
+  "agent.utility_model": {
+    type: "string",
+    category: "Agent",
+    description: "Cheap model for summarization (auto-detected if empty)",
+    sensitive: false,
+    validate: noValidation,
+    mask: identity,
+    parse: identity
+  },
+  "agent.temperature": {
+    type: "number",
+    category: "Agent",
+    description: "Response creativity (0.0 = deterministic, 2.0 = max)",
+    sensitive: false,
+    validate: numberInRange(0, 2),
+    mask: identity,
+    parse: (v) => Number(v)
+  },
+  "agent.max_tokens": {
+    type: "number",
+    category: "Agent",
+    description: "Maximum response length in tokens",
+    sensitive: false,
+    validate: numberInRange(256, 128e3),
+    mask: identity,
+    parse: (v) => Number(v)
+  },
+  "agent.max_agentic_iterations": {
+    type: "number",
+    category: "Agent",
+    description: "Max tool-call loop iterations per message",
+    sensitive: false,
+    validate: numberInRange(1, 20),
+    mask: identity,
+    parse: (v) => Number(v)
+  },
+  // ─── Session ───────────────────────────────────────────────────
+  "agent.session_reset_policy.daily_reset_enabled": {
+    type: "boolean",
+    category: "Session",
+    description: "Enable daily session reset at specified hour",
+    sensitive: false,
+    validate: enumValidator(["true", "false"]),
+    mask: identity,
+    parse: (v) => v === "true"
+  },
+  "agent.session_reset_policy.daily_reset_hour": {
+    type: "number",
+    category: "Session",
+    description: "Hour (0-23 UTC) for daily session reset",
+    sensitive: false,
+    validate: numberInRange(0, 23),
+    mask: identity,
+    parse: (v) => Number(v)
+  },
+  "agent.session_reset_policy.idle_expiry_enabled": {
+    type: "boolean",
+    category: "Session",
+    description: "Enable automatic session expiry after idle period",
+    sensitive: false,
+    validate: enumValidator(["true", "false"]),
+    mask: identity,
+    parse: (v) => v === "true"
+  },
+  "agent.session_reset_policy.idle_expiry_minutes": {
+    type: "number",
+    category: "Session",
+    description: "Idle minutes before session expires (minimum 1)",
+    sensitive: false,
+    validate: numberInRange(1, Number.MAX_SAFE_INTEGER),
+    mask: identity,
+    parse: (v) => Number(v)
+  },
+  // ─── Telegram ──────────────────────────────────────────────────────
+  "telegram.bot_username": {
+    type: "string",
+    category: "Telegram",
+    description: "Bot username without @",
+    sensitive: false,
+    validate: (v) => v.length >= 3 ? void 0 : "Must be at least 3 characters",
+    mask: identity,
+    parse: identity
+  },
+  "telegram.dm_policy": {
+    type: "enum",
+    category: "Telegram",
+    description: "DM access policy",
+    sensitive: false,
+    options: ["pairing", "allowlist", "open", "disabled"],
+    validate: enumValidator(["pairing", "allowlist", "open", "disabled"]),
+    mask: identity,
+    parse: identity
+  },
+  "telegram.group_policy": {
+    type: "enum",
+    category: "Telegram",
+    description: "Group access policy",
+    sensitive: false,
+    options: ["open", "allowlist", "disabled"],
+    validate: enumValidator(["open", "allowlist", "disabled"]),
+    mask: identity,
+    parse: identity
+  },
+  "telegram.require_mention": {
+    type: "boolean",
+    category: "Telegram",
+    description: "Require @mention in groups to respond",
+    sensitive: false,
+    validate: enumValidator(["true", "false"]),
+    mask: identity,
+    parse: (v) => v === "true"
+  },
+  "telegram.owner_name": {
+    type: "string",
+    category: "Telegram",
+    description: "Owner's first name (used in system prompt)",
+    sensitive: false,
+    validate: noValidation,
+    mask: identity,
+    parse: identity
+  },
+  "telegram.owner_username": {
+    type: "string",
+    category: "Telegram",
+    description: "Owner's Telegram username (without @)",
+    sensitive: false,
+    validate: noValidation,
+    mask: identity,
+    parse: identity
+  },
+  "telegram.debounce_ms": {
+    type: "number",
+    category: "Telegram",
+    description: "Group message debounce delay in ms (0 = disabled)",
+    sensitive: false,
+    validate: numberInRange(0, 1e4),
+    mask: identity,
+    parse: (v) => Number(v)
+  },
+  "telegram.agent_channel": {
+    type: "string",
+    category: "Telegram",
+    description: "Channel username for auto-publishing",
+    sensitive: false,
+    validate: noValidation,
+    mask: identity,
+    parse: identity
+  },
+  "telegram.typing_simulation": {
+    type: "boolean",
+    category: "Telegram",
+    description: "Simulate typing indicator before sending replies",
+    sensitive: false,
+    validate: enumValidator(["true", "false"]),
+    mask: identity,
+    parse: (v) => v === "true"
+  },
+  // ─── Embedding ─────────────────────────────────────────────────────
+  "embedding.provider": {
+    type: "enum",
+    category: "Embedding",
+    description: "Embedding provider for RAG",
+    sensitive: false,
+    options: ["local", "anthropic", "none"],
+    validate: enumValidator(["local", "anthropic", "none"]),
+    mask: identity,
+    parse: identity
+  },
+  // ─── WebUI ─────────────────────────────────────────────────────────
+  "webui.port": {
+    type: "number",
+    category: "WebUI",
+    description: "HTTP server port (requires restart)",
+    sensitive: false,
+    validate: numberInRange(1024, 65535),
+    mask: identity,
+    parse: (v) => Number(v)
+  },
+  "webui.log_requests": {
+    type: "boolean",
+    category: "WebUI",
+    description: "Log all HTTP requests to console",
+    sensitive: false,
+    validate: enumValidator(["true", "false"]),
+    mask: identity,
+    parse: (v) => v === "true"
+  },
+  // ─── Deals ─────────────────────────────────────────────────────────
+  "deals.enabled": {
+    type: "boolean",
+    category: "Deals",
+    description: "Enable the deals/escrow module",
+    sensitive: false,
+    validate: enumValidator(["true", "false"]),
+    mask: identity,
+    parse: (v) => v === "true"
+  },
+  // ─── Developer ─────────────────────────────────────────────────────
+  "dev.hot_reload": {
+    type: "boolean",
+    category: "Developer",
+    description: "Watch ~/.teleton/plugins/ for live changes",
+    sensitive: false,
+    validate: enumValidator(["true", "false"]),
+    mask: identity,
+    parse: (v) => v === "true"
+  }
+};
+var FORBIDDEN_SEGMENTS = /* @__PURE__ */ new Set(["__proto__", "constructor", "prototype"]);
+function assertSafePath(parts) {
+  if (parts.some((p) => FORBIDDEN_SEGMENTS.has(p))) {
+    throw new Error("Invalid config path: forbidden segment");
+  }
+}
+function getNestedValue(obj, path) {
+  const parts = path.split(".");
+  assertSafePath(parts);
+  let current = obj;
+  for (const part of parts) {
+    if (current == null || typeof current !== "object") return void 0;
+    current = current[part];
+  }
+  return current;
+}
+function setNestedValue(obj, path, value) {
+  const parts = path.split(".");
+  assertSafePath(parts);
+  let current = obj;
+  for (let i = 0; i < parts.length - 1; i++) {
+    if (current[parts[i]] == null || typeof current[parts[i]] !== "object") {
+      current[parts[i]] = {};
+    }
+    current = current[parts[i]];
+  }
+  current[parts[parts.length - 1]] = value;
+}
+function deleteNestedValue(obj, path) {
+  const parts = path.split(".");
+  assertSafePath(parts);
+  let current = obj;
+  for (let i = 0; i < parts.length - 1; i++) {
+    if (current == null || typeof current !== "object") return;
+    current = current[parts[i]];
+  }
+  if (current != null && typeof current === "object") {
+    delete current[parts[parts.length - 1]];
+  }
+}
+function readRawConfig(configPath) {
+  const fullPath = expandPath(configPath);
+  if (!existsSync(fullPath)) {
+    throw new Error(`Config file not found: ${fullPath}
+Run 'teleton setup' to create one.`);
+  }
+  const raw = parse(readFileSync(fullPath, "utf-8"));
+  if (!raw || typeof raw !== "object") {
+    throw new Error(`Invalid config file: ${fullPath}`);
+  }
+  return raw;
+}
+function writeRawConfig(raw, configPath) {
+  const clone = { ...raw };
+  delete clone.market;
+  const result = ConfigSchema.safeParse(clone);
+  if (!result.success) {
+    throw new Error(`Refusing to save invalid config: ${result.error.message}`);
+  }
+  raw.meta = raw.meta ?? {};
+  raw.meta.last_modified_at = (/* @__PURE__ */ new Date()).toISOString();
+  const fullPath = expandPath(configPath);
+  writeFileSync(fullPath, stringify(raw), "utf-8");
+  chmodSync(fullPath, 384);
+}
+
+export {
+  CONFIGURABLE_KEYS,
+  getNestedValue,
+  setNestedValue,
+  deleteNestedValue,
+  readRawConfig,
+  writeRawConfig
+};