cartethyia 2.7.4 → 2.7.6

package/src/console/cli-tools/injectors/droid.ts

@@ -1,96 +0,0 @@
-import type {} from "../contracts";
-import { jsonDownload } from "../contracts";
-import { ensureV1Suffix, homeDir, readJsonFile, writeJsonFile } from "../fs-ops";
-import type { InjectorSpec } from "../contracts";
-
-
-// Factory Droid injector spec.
-const DROID_PREFIX = "custom:Cartethyia";
-
-interface DroidCustomModel {
-  id: string;
-  name: string;
-  baseUrl: string;
-  apiKey: string;
-  provider: string;
-}
-
-interface DroidSettings {
-  customModels?: DroidCustomModel[];
-  model?: string;
-  [k: string]: unknown;
-}
-
-function isCartethyiaDroidModel(m: { id?: string } | null | undefined): boolean {
-  return typeof m?.id === "string" && m.id.startsWith(DROID_PREFIX);
-}
-
-export const droidSpec: InjectorSpec = {
-  toolId: "droid",
-  displayName: "Factory Droid",
-  binary: "droid",
-  resolvePath: () => `${homeDir()}/.factory/settings.json`,
-  resolveDir: () => `${homeDir()}/.factory`,
-
-  async readStatus(path) {
-    const settings = (await readJsonFile(path)) as DroidSettings | null;
-    const ours = (settings?.customModels ?? []).filter(isCartethyiaDroidModel);
-    if (ours.length === 0) {
-      return { configured: false, currentEndpoint: null, rawApiKey: null, currentModels: null };
-    }
-    const first = ours[0]!;
-    return {
-      configured: true,
-      currentEndpoint: first.baseUrl ?? null,
-      rawApiKey: first.apiKey,
-      currentModels: ours.map((m) => m.name),
-    };
-  },
-
-  async apply(input, path) {
-    const existing = ((await readJsonFile(path)) as DroidSettings | null) ?? {};
-    const settings: DroidSettings = { ...existing };
-    const kept = (settings.customModels ?? []).filter((m) => !isCartethyiaDroidModel(m));
-    const baseUrl = ensureV1Suffix(input.endpoint);
-    const apiKey = input.apiKey || "your_api_key";
-    const added = input.modelIds.map((m): DroidCustomModel => ({
-      id: `${DROID_PREFIX}:${m}`,
-      name: m,
-      baseUrl,
-      apiKey,
-      provider: "openai",
-    }));
-    settings.customModels = [...kept, ...added];
-    if (input.activeModel) settings.model = input.activeModel;
-    await writeJsonFile(path, settings);
-  },
-
-  async reset(path) {
-    const settings = (await readJsonFile(path)) as DroidSettings | null;
-    if (!settings) return false;
-    if (settings.customModels) {
-      settings.customModels = settings.customModels.filter((m) => !isCartethyiaDroidModel(m));
-      if (settings.customModels.length === 0) delete settings.customModels;
-    }
-    await writeJsonFile(path, settings);
-  },
-
-  download(input) {
-    const baseUrl = ensureV1Suffix(input.endpoint);
-    const apiKey = input.apiKey || "your_api_key";
-    const customModels = input.modelIds.map((m): DroidCustomModel => ({
-      id: `${DROID_PREFIX}:${m}`,
-      name: m,
-      baseUrl,
-      apiKey,
-      provider: "openai",
-    }));
-    return jsonDownload({ customModels }, { filename: "settings.json" });
-  },
-
-  messages: {
-    applied: "Factory Droid settings applied",
-    reset: "Cartethyia settings removed from Factory Droid",
-  },
-};
-

package/src/console/cli-tools/injectors/grok-build.ts

@@ -1,70 +0,0 @@
-import type {} from "../contracts";
-import { resolveApplyTarget, textDownload } from "../contracts";
-import { checkBinaryInstalled, homeDir, readTextFile, textGet, textHas, textRemove, textUpsert, writeTextFile } from "../fs-ops";
-import type { InjectorSpec } from "../contracts";
-
-
-// Grok Build injector spec.
-function grokModelSectionBody(model: string, baseUrl: string, apiKey: string): string {
-  const lines = [`default = "${model}"`, `base_url = "${baseUrl}"`, `provider = "custom"`];
-  if (apiKey) lines.push(`api_key = "${apiKey}"`);
-  return lines.join("\n");
-}
-
-export const grokBuildSpec: InjectorSpec = {
-  toolId: "grok-build",
-  displayName: "Grok Build",
-  checkInstalled: async () => {
-    return checkBinaryInstalled("grok");
-  },
-  resolvePath: () => `${homeDir()}/.grok/config.toml`,
-  resolveDir: () => `${homeDir()}/.grok`,
-
-  async readStatus(path) {
-    const text = await readTextFile(path);
-    if (!text) {
-      return { configured: false, currentEndpoint: null, rawApiKey: null, currentModels: null };
-    }
-    const baseUrl = textGet(text, { kind: "flat", key: "base_url" });
-    const model = textGet(text, { kind: "flat", key: "default" });
-    const apiKey = textGet(text, { kind: "flat", key: "api_key" });
-    const configured = textHas(text, { kind: "section", section: "model" }) && baseUrl !== null;
-    return {
-      configured,
-      currentEndpoint: baseUrl,
-      rawApiKey: apiKey,
-      currentModels: model ? [model] : null,
-    };
-  },
-
-  async apply(input, path) {
-    const { model, baseUrl } = resolveApplyTarget(input);
-    let text = (await readTextFile(path)) ?? "";
-    text = textUpsert(
-      text,
-      { kind: "section", section: "model" },
-      grokModelSectionBody(model, baseUrl, input.apiKey),
-    );
-    await writeTextFile(path, text);
-  },
-
-  async reset(path) {
-    let text = await readTextFile(path);
-    if (!text) return false;
-    text = textRemove(text, { kind: "section", section: "model" });
-    await writeTextFile(path, text);
-  },
-
-  download(input) {
-    const { model, baseUrl } = resolveApplyTarget(input);
-    const body = grokModelSectionBody(model, baseUrl, input.apiKey);
-    return textDownload(`[model]\n${body}\n`, { filename: "grok-config.toml" });
-  },
-
-  messages: {
-    applied: "Grok Build settings applied",
-    reset: "Cartethyia settings removed from Grok Build",
-    resetMissing: "No config file to reset",
-  },
-};
-

package/src/console/cli-tools/injectors/hermes.ts

@@ -1,101 +0,0 @@
-import type {} from "../contracts";
-import { resolveApplyTarget, textDownload } from "../contracts";
-import { homeDir, isLocalEndpoint, readTextFile, textGet, textRemove, textUpsert, writeTextFile } from "../fs-ops";
-import type { InjectorSpec } from "../contracts";
-
-
-// Hermes Agent injector spec.
-const HERMES_MODEL_BLOCK_RE = /^model:[ \t]*\r?\n((?:[ \t]+.*\r?\n?|[ \t]*\r?\n)*)/m;
-
-function parseHermesModelBlock(
-  yaml: string,
-): { default: string | null; provider: string | null; base_url: string | null } | null {
-  const match = yaml.match(HERMES_MODEL_BLOCK_RE);
-  if (!match) return null;
-  const body = match[1] ?? "";
-  const get = (key: string): string | null => {
-    const m = body.match(new RegExp(`^[ \\t]+${key}:[ \\t]*["']?([^"'\\r\\n]+)["']?`, "m"));
-    return m ? (m[1] ?? "").trim() : null;
-  };
-  return { default: get("default"), provider: get("provider"), base_url: get("base_url") };
-}
-
-const hermesEnvPath = () => `${homeDir()}/.hermes/.env`;
-
-export const hermesSpec: InjectorSpec = {
-  toolId: "hermes",
-  displayName: "Hermes Agent",
-  binary: "hermes",
-  resolvePath: () => `${homeDir()}/.hermes/config.yaml`,
-  resolveDir: () => `${homeDir()}/.hermes`,
-
-  async readStatus(path) {
-    const text = await readTextFile(path);
-    if (!text) {
-      return { configured: false, currentEndpoint: null, rawApiKey: null, currentModels: null };
-    }
-    const model = parseHermesModelBlock(text);
-    const baseUrl = model?.base_url ?? null;
-    const envText = await readTextFile(hermesEnvPath());
-    const apiKey = envText
-      ? textGet(envText, { kind: "flat", key: "OPENAI_API_KEY", format: "env" })
-      : null;
-    const configured = model?.provider === "custom" && isLocalEndpoint(baseUrl);
-    return {
-      configured,
-      currentEndpoint: baseUrl,
-      rawApiKey: apiKey,
-      currentModels: model?.default ? [model.default] : null,
-    };
-  },
-
-  async apply(input, path) {
-    const { model, baseUrl } = resolveApplyTarget(input);
-    const block = `model:\n  default: "${model}"\n  provider: "custom"\n  base_url: "${baseUrl}"\n`;
-
-    let yaml = (await readTextFile(path)) ?? "";
-    yaml = HERMES_MODEL_BLOCK_RE.test(yaml)
-      ? yaml.replace(HERMES_MODEL_BLOCK_RE, block)
-      : yaml.length > 0
-        ? `${block}\n${yaml}`
-        : block;
-    await writeTextFile(path, yaml);
-
-    let envText = (await readTextFile(hermesEnvPath())) ?? "";
-    envText = textUpsert(
-      envText,
-      { kind: "flat", key: "OPENAI_API_KEY", format: "env" },
-      input.apiKey,
-    );
-    await writeTextFile(hermesEnvPath(), envText);
-  },
-
-  async reset(path) {
-    const yaml = await readTextFile(path);
-    if (yaml) {
-      await writeTextFile(path, yaml.replace(HERMES_MODEL_BLOCK_RE, "").replace(/^\n+/, ""));
-    }
-    const envText = await readTextFile(hermesEnvPath());
-    if (envText) {
-      await writeTextFile(
-        hermesEnvPath(),
-        textRemove(envText, { kind: "flat", key: "OPENAI_API_KEY", format: "env" }),
-      );
-    }
-  },
-
-  download(input) {
-    const { model, baseUrl } = resolveApplyTarget(input);
-    const yaml = `model:\n  default: "${model}"\n  provider: "custom"\n  base_url: "${baseUrl}"\n`;
-    const envFile = `OPENAI_API_KEY=${input.apiKey}\n`;
-    return textDownload(`# ~/.hermes/config.yaml\n${yaml}\n# ~/.hermes/.env\n${envFile}`, {
-      filename: "hermes-config.txt",
-    });
-  },
-
-  messages: {
-    applied: "Hermes Agent settings applied",
-    reset: "Cartethyia settings removed from Hermes Agent",
-  },
-};
-

package/src/console/cli-tools/injectors/jcode.ts

@@ -1,115 +0,0 @@
-import type {} from "../contracts";
-import { ensureDir, ensureV1Suffix, homeDir, isLocalEndpoint, join, readTextFile, textGet, textHas, textRemove, textUpsert, writeTextFile } from "../fs-ops";
-import type { InjectorSpec } from "../contracts";
-
-
-// Jcode injector spec.
-function jcodeEnvFileDir(): string {
-  return join(process.env.XDG_CONFIG_HOME ?? join(homeDir(), ".config"), "jcode");
-}
-
-function jcodeEnvFilePath(): string {
-  return join(jcodeEnvFileDir(), "provider-cartethyia.env");
-}
-
-export const jcodeSpec: InjectorSpec = {
-  toolId: "jcode",
-  displayName: "jcode",
-  binary: "jcode",
-  resolvePath: () => join(homeDir(), ".jcode", "config.toml"),
-  resolveDir: () => join(homeDir(), ".jcode"),
-
-  async readStatus(path) {
-    const text = await readTextFile(path);
-    if (!text) {
-      return { configured: false, currentEndpoint: null, rawApiKey: null, currentModels: null };
-    }
-    const configured = textHas(text, { kind: "section", section: "providers.cartethyia" });
-    // `base_url` is written inside `[providers.cartethyia]` by `apply` below, so
-    // it must be read from that section. Reading it as a root key returned null
-    // for a config this injector had just written, so a configured tool
-    // reported no endpoint.
-    const baseUrl = textGet(text, {
-      kind: "sectionKey",
-      section: "providers.cartethyia",
-      key: "base_url",
-    });
-    const envText = await readTextFile(jcodeEnvFilePath());
-    const apiKey = envText
-      ? textGet(envText, { kind: "flat", key: "OPENAI_API_KEY", format: "env" })
-      : null;
-    return {
-      configured,
-      currentEndpoint: isLocalEndpoint(baseUrl) ? baseUrl : null,
-      rawApiKey: apiKey,
-      currentModels: null,
-    };
-  },
-
-  async apply(input, path) {
-    const model = input.activeModel ?? input.modelIds[0] ?? "";
-    const baseUrl = ensureV1Suffix(input.endpoint);
-
-    let text = (await readTextFile(path)) ?? "";
-    text = textUpsert(
-      text,
-      { kind: "section", section: "providers.cartethyia" },
-      [
-        `  type = "openai"`,
-        `  base_url = "${baseUrl}"`,
-        `  env_file = "provider-cartethyia.env"`,
-        `  model = "${model}"`,
-      ].join("\n"),
-    );
-    await writeTextFile(path, text);
-
-    await ensureDir(jcodeEnvFileDir());
-    let envText = (await readTextFile(jcodeEnvFilePath())) ?? "";
-    envText = textUpsert(
-      envText,
-      { kind: "flat", key: "OPENAI_API_KEY", format: "env" },
-      input.apiKey,
-    );
-    await writeTextFile(jcodeEnvFilePath(), envText);
-  },
-
-  async reset(path) {
-    let text = await readTextFile(path);
-    if (text) {
-      text = textRemove(text, { kind: "section", section: "providers.cartethyia" });
-      await writeTextFile(path, text);
-    }
-    const envText = await readTextFile(jcodeEnvFilePath());
-    if (envText) {
-      await writeTextFile(
-        jcodeEnvFilePath(),
-        textRemove(envText, { kind: "flat", key: "OPENAI_API_KEY", format: "env" }),
-      );
-    }
-  },
-
-  download(input) {
-    const model = input.activeModel ?? input.modelIds[0] ?? "";
-    const baseUrl = ensureV1Suffix(input.endpoint);
-    const toml = [
-      `[providers.cartethyia]`,
-      `  type = "openai"`,
-      `  base_url = "${baseUrl}"`,
-      `  env_file = "provider-cartethyia.env"`,
-      `  model = "${model}"`,
-      "",
-    ].join("\n");
-    const envFile = `OPENAI_API_KEY=${input.apiKey}\n`;
-    return {
-      content: `# config.toml\n${toml}\n# provider-cartethyia.env\n${envFile}`,
-      filename: "jcode-config.txt",
-      mimeType: "text/plain",
-    };
-  },
-
-  messages: {
-    applied: "jcode settings applied",
-    reset: "Cartethyia settings removed from jcode",
-  },
-};
-

package/src/console/cli-tools/injectors/openclaw.ts

@@ -1,161 +0,0 @@
-import type {} from "../contracts";
-import { ensureV1Suffix, homeDir, join, readJsonFile, writeJsonFile } from "../fs-ops";
-import type { InjectorSpec } from "../contracts";
-
-
-// Open Claw injector spec.
-function resolveOpenclawModel(m: unknown): string {
-  if (typeof m === "string") return m;
-  if (m !== null && typeof m === "object" && "primary" in m) {
-    return (m as { primary: string }).primary;
-  }
-  return "";
-}
-
-export const openclawSpec: InjectorSpec = {
-  toolId: "openclaw",
-  displayName: "Open Claw",
-  binary: "openclaw",
-  resolvePath: () => join(homeDir(), ".openclaw", "openclaw.json"),
-  resolveDir: () => join(homeDir(), ".openclaw"),
-
-  async readStatus(path) {
-    const settings = (await readJsonFile(path)) as {
-      models?: {
-        providers?: Record<
-          string,
-          { baseUrl?: string; apiKey?: string; models?: Array<{ id: string }> }
-        >;
-      };
-      agents?: { defaults?: { model?: { primary?: string } | string } };
-    } | null;
-    if (!settings) {
-      return { configured: false, currentEndpoint: null, rawApiKey: null, currentModels: null };
-    }
-    const provider = settings.models?.providers?.cartethyia;
-    const primaryModel = resolveOpenclawModel(settings.agents?.defaults?.model);
-    return {
-      configured: !!provider,
-      currentEndpoint: provider?.baseUrl ?? null,
-      rawApiKey: provider?.apiKey ?? null,
-      currentModels: primaryModel ? [primaryModel] : (provider?.models?.map((m) => m.id) ?? null),
-    };
-  },
-
-  async apply(input, path) {
-    const settings = ((await readJsonFile(path)) as Record<string, unknown> | null) ?? {};
-
-    if (typeof settings.models !== "object" || settings.models === null) settings.models = {};
-    const models = settings.models as Record<string, unknown>;
-    if (typeof models.providers !== "object" || models.providers === null) models.providers = {};
-    const providers = models.providers as Record<string, unknown>;
-
-    if (typeof settings.agents !== "object" || settings.agents === null) settings.agents = {};
-    const agents = settings.agents as Record<string, unknown>;
-    if (typeof agents.defaults !== "object" || agents.defaults === null) agents.defaults = {};
-    const defaults = agents.defaults as Record<string, unknown>;
-    if (typeof defaults.model !== "object" || defaults.model === null) defaults.model = {};
-    if (typeof defaults.models !== "object" || defaults.models === null) defaults.models = {};
-
-    const baseUrl = ensureV1Suffix(input.endpoint);
-    const allModels = [
-      ...new Set([...input.modelIds, ...(input.activeModel ? [input.activeModel] : [])]),
-    ];
-
-    const defaultModels = defaults.models as Record<string, unknown>;
-    for (const key of Object.keys(defaultModels)) {
-      if (key.startsWith("cartethyia/")) delete defaultModels[key];
-    }
-
-    (defaults.model as { primary: string }).primary =
-      `cartethyia/${input.activeModel ?? input.modelIds[0] ?? ""}`;
-
-    for (const m of allModels) defaultModels[`cartethyia/${m}`] = {};
-
-    providers.cartethyia = {
-      baseUrl,
-      apiKey: input.apiKey,
-      api: "openai-completions",
-      models: allModels.map((m) => ({ id: m, name: m.split("/").pop() ?? m })),
-    };
-
-    if (Array.isArray(agents.list)) {
-      agents.list = (agents.list as Array<Record<string, unknown>>).map((agent) => {
-        if (resolveOpenclawModel(agent.model).startsWith("cartethyia/")) {
-          const { model: _m, ...rest } = agent;
-          void _m;
-          return rest;
-        }
-        return agent;
-      });
-    }
-
-    await writeJsonFile(path, settings);
-  },
-
-  async reset(path) {
-    const settings = (await readJsonFile(path)) as {
-      models?: { providers?: Record<string, unknown> };
-      agents?: {
-        defaults?: { model?: { primary?: string } | string; models?: Record<string, unknown> };
-      };
-    } | null;
-    if (!settings) return false;
-
-    delete settings.models?.providers?.cartethyia;
-
-    const defaultModels = settings.agents?.defaults?.models;
-    if (defaultModels) {
-      for (const key of Object.keys(defaultModels)) {
-        if (key.startsWith("cartethyia/")) delete defaultModels[key];
-      }
-    }
-
-    const primary = resolveOpenclawModel(settings.agents?.defaults?.model);
-    if (primary.startsWith("cartethyia/")) {
-      if (settings.agents?.defaults?.model && typeof settings.agents.defaults.model === "object") {
-        (settings.agents.defaults.model as { primary: string }).primary = "";
-      }
-    }
-
-    await writeJsonFile(path, settings);
-  },
-
-  download(input) {
-    const baseUrl = ensureV1Suffix(input.endpoint);
-    const model = input.activeModel ?? input.modelIds[0] ?? "";
-    const allModels = [...new Set([...input.modelIds, model])];
-    return {
-      content: JSON.stringify(
-        {
-          models: {
-            providers: {
-              cartethyia: {
-                baseUrl,
-                apiKey: input.apiKey,
-                api: "openai-completions",
-                models: allModels.map((m) => ({ id: m, name: m.split("/").pop() ?? m })),
-              },
-            },
-          },
-          agents: {
-            defaults: {
-              model: { primary: `cartethyia/${model}` },
-              models: Object.fromEntries(allModels.map((m) => [`cartethyia/${m}`, {}])),
-            },
-          },
-        },
-        null,
-        2,
-      ),
-      filename: "openclaw.json",
-      mimeType: "application/json",
-    };
-  },
-
-  messages: {
-    applied: "Open Claw settings applied",
-    reset: "Cartethyia settings removed from Open Claw",
-  },
-};
-

package/src/network/response-headers.ts

@@ -1,39 +0,0 @@
-/**
- * Upstream response header sanitization for the validated egress path.
- *
- * Upstream responses must not hand gateway state or credentials to callers:
- * strip Set-Cookie/auth challenges and hop-by-hop fields; keep everything
- * content-bearing (content-type, location, etc.). Keeping this in one module
- * means every transport applies the identical allow/deny policy.
- */
-
-/** Hop-by-hop and credential-bearing headers never forwarded to callers. */
-export const STRIPPED_RESPONSE_HEADERS = new Set([
-  "set-cookie",
-  "authorization",
-  "cookie",
-  "www-authenticate",
-  "proxy-authenticate",
-  "proxy-authorization",
-  "connection",
-  "keep-alive",
-  "proxy-connection",
-  "transfer-encoding",
-  "te",
-  "trailer",
-  "upgrade",
-]);
-
-/** Filters raw upstream response headers down to the forwardable set. */
-export function stripResponseHeaders(
-  raw: Record<string, string | string[] | undefined>,
-): Headers {
-  const headers = new Headers();
-  for (const [key, value] of Object.entries(raw)) {
-    if (value === undefined) continue;
-    if (key.startsWith(":")) continue;
-    if (STRIPPED_RESPONSE_HEADERS.has(key.toLowerCase())) continue;
-    headers.set(key, Array.isArray(value) ? value.join(", ") : value);
-  }
-  return headers;
-}

package/src/protocol/response/dsml.ts

@@ -1,38 +0,0 @@
-/**
- * CodeBuddy-family DeepSeek sometimes emits native tool markup as assistant text.
- * Complete declared calls are recovered; incomplete and undeclared blocks stay text.
- *
- * The mechanics live in `../dsml` with the CodeBuddy dialect as default; this
- * module keeps the historical public surface (`DsmlToolCallParser`,
- * `parseDsmlToolCalls`) stable for this wire family.
- */
-import {
-  DsmlStreamParser,
-  type DsmlToolCall,
-} from "../dsml";
-
-export type { DsmlToolCall } from "../dsml";
-
-export interface DsmlRecovery {
-  readonly text: string;
-  readonly calls: readonly DsmlToolCall[];
-}
-
-/** Streaming strict-prefix parser with the CodeBuddy dialect defaults. */
-export class DsmlToolCallParser extends DsmlStreamParser {
-  constructor(allowedNames: ReadonlySet<string>) {
-    super({ allowedNames });
-  }
-}
-
-export function parseDsmlToolCalls(
-  text: string,
-  allowedNames: ReadonlySet<string> = new Set(),
-): DsmlRecovery | undefined {
-  if (!text.includes("DSML")) return undefined;
-  const parser = new DsmlToolCallParser(allowedNames);
-  const first = parser.push(text);
-  const last = parser.flush();
-  const recovered = [...first.calls, ...last.calls];
-  return recovered.length === 0 ? undefined : { text: `${first.text}${last.text}`.trim(), calls: recovered };
-}