Skip to content

Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.

4.8 KB
Raw Blame
export type AddResourceCommandArgs = {
  source?: string;
  to?: string;
  parent?: string;
  reason?: string;
  instruction?: string;
  wait?: boolean;
};

export type AddSkillCommandArgs = {
  source?: string;
  data?: unknown;
  wait?: boolean;
};

export type OVSearchCommandArgs = {
  query: string;
  uri?: string;
  limit?: number;
};

export function tokenizeCommandArgs(args: string): string[] {
  const tokens: string[] = [];
  let current = "";
  let quote: "'" | '"' | null = null;
  let escaping = false;

  for (let i = 0; i < args.length; i += 1) {
    const ch = args[i]!;
    const next = args[i + 1];
    if (escaping) {
      current += ch;
      escaping = false;
      continue;
    }
    if (ch === "\\") {
      const shouldEscape =
        quote === '"'
          ? next === '"' || next === "\\"
          : !quote && Boolean(next && (/\s/.test(next) || next === '"' || next === "'"));
      if (shouldEscape) {
        escaping = true;
        continue;
      }
      current += ch;
      continue;
    }
    if ((ch === '"' || ch === "'") && (!quote || quote === ch)) {
      quote = quote ? null : ch;
      continue;
    }
    if (!quote && /\s/.test(ch)) {
      if (current) {
        tokens.push(current);
        current = "";
      }
      continue;
    }
    current += ch;
  }

  if (escaping) {
    current += "\\";
  }
  if (quote) {
    throw new Error("Unterminated quoted argument");
  }
  if (current) {
    tokens.push(current);
  }
  return tokens;
}

type ParsedFlagArgs = {
  positionals: string[];
  flags: Map<string, string | boolean>;
};

function parseFlagArgs(args: string): ParsedFlagArgs {
  const tokens = tokenizeCommandArgs(args);
  const positionals: string[] = [];
  const flags = new Map<string, string | boolean>();

  for (let i = 0; i < tokens.length; i += 1) {
    const token = tokens[i]!;
    if (!token.startsWith("--")) {
      positionals.push(token);
      continue;
    }
    const raw = token.slice(2);
    if (!raw) {
      continue;
    }
    const eqIndex = raw.indexOf("=");
    if (eqIndex >= 0) {
      flags.set(raw.slice(0, eqIndex), raw.slice(eqIndex + 1));
      continue;
    }
    const next = tokens[i + 1];
    if (next && !next.startsWith("--")) {
      flags.set(raw, next);
      i += 1;
    } else {
      flags.set(raw, true);
    }
  }

  return { positionals, flags };
}

function getStringFlag(flags: Map<string, string | boolean>, name: string): string | undefined {
  const value = flags.get(name);
  return typeof value === "string" && value.trim() ? value.trim() : undefined;
}

function getNumberFlag(flags: Map<string, string | boolean>, name: string): number | undefined {
  const raw = getStringFlag(flags, name);
  if (!raw) {
    return undefined;
  }
  const value = Number(raw);
  if (!Number.isFinite(value)) {
    throw new Error(`--${name} must be a number`);
  }
  return value;
}

function getBoolFlag(flags: Map<string, string | boolean>, name: string): boolean {
  return flags.get(name) === true;
}

export function parseAddResourceCommandArgs(args: string): AddResourceCommandArgs {
  const parsed = parseFlagArgs(args);
  const source =
    parsed.positionals.length <= 1 ? parsed.positionals[0] : parsed.positionals.join(" ").trim();
  if (!source) {
    throw new Error("Usage: /add-resource <source> [--to URI] [--parent URI] [--reason TEXT] [--instruction TEXT] [--wait]");
  }
  const to = getStringFlag(parsed.flags, "to");
  const parent = getStringFlag(parsed.flags, "parent");
  if (to && parent) {
    throw new Error("Cannot specify both --to and --parent.");
  }
  return {
    source,
    to,
    parent,
    reason: getStringFlag(parsed.flags, "reason"),
    instruction: getStringFlag(parsed.flags, "instruction"),
    wait: getBoolFlag(parsed.flags, "wait"),
  };
}

export function parseAddSkillCommandArgs(args: string): AddSkillCommandArgs {
  const parsed = parseFlagArgs(args);
  const source =
    parsed.positionals.length <= 1 ? parsed.positionals[0] : parsed.positionals.join(" ").trim();
  if (!source) {
    throw new Error("Usage: /add-skill <source> [--wait]");
  }
  if (parsed.flags.has("to") || parsed.flags.has("parent") || parsed.flags.has("reason") || parsed.flags.has("instruction")) {
    throw new Error("--to, --parent, --reason, and --instruction are resource-only options.");
  }
  return {
    source,
    wait: getBoolFlag(parsed.flags, "wait"),
  };
}

export function parseOVSearchCommandArgs(args: string): OVSearchCommandArgs {
  const parsed = parseFlagArgs(args);
  // `/ov-search` only accepts a single query string, so positional segments are
  // always re-joined to preserve unquoted multi-word searches.
  const query = parsed.positionals.join(" ").trim();
  if (!query) {
    throw new Error('Usage: /ov-search "<query>" [--uri URI] [--limit N]');
  }
  return {
    query,
    uri: getStringFlag(parsed.flags, "uri"),
    limit: getNumberFlag(parsed.flags, "limit"),
  };
}