@stackmemoryai/stackmemory 1.10.5 → 1.14.0

package/dist/src/integrations/mcp/tool-alias-registry.js

@@ -0,0 +1,297 @@
+import { fileURLToPath as __fileURLToPath } from 'url';
+import { dirname as __pathDirname } from 'path';
+const __filename = __fileURLToPath(import.meta.url);
+const __dirname = __pathDirname(__filename);
+const TOOL_ALIASES = {
+  // --- Context tools ---
+  context: "get_context",
+  get_ctx: "get_context",
+  sm_context: "get_context",
+  sm_get_context: "get_context",
+  fetch_context: "get_context",
+  read_context: "get_context",
+  record_decision: "add_decision",
+  log_decision: "add_decision",
+  save_decision: "add_decision",
+  sm_decision: "add_decision",
+  push_frame: "start_frame",
+  open_frame: "start_frame",
+  begin_frame: "start_frame",
+  new_frame: "start_frame",
+  pop_frame: "close_frame",
+  end_frame: "close_frame",
+  finish_frame: "close_frame",
+  anchor: "add_anchor",
+  sm_anchor: "add_anchor",
+  save_anchor: "add_anchor",
+  hot_stack: "get_hot_stack",
+  stack: "get_hot_stack",
+  sm_stack: "get_hot_stack",
+  // --- Task tools ---
+  new_task: "create_task",
+  add_task: "create_task",
+  sm_task: "create_task",
+  sm_create_task: "create_task",
+  update_task: "update_task_status",
+  set_task_status: "update_task_status",
+  task_update: "update_task_status",
+  list_tasks: "get_active_tasks",
+  tasks: "get_active_tasks",
+  sm_tasks: "get_active_tasks",
+  active_tasks: "get_active_tasks",
+  task_metrics: "get_task_metrics",
+  metrics: "get_task_metrics",
+  // --- Search & Discovery ---
+  sm_context_search: "sm_search",
+  search: "sm_search",
+  context_search: "sm_search",
+  sm_find: "sm_search",
+  find: "sm_search",
+  discover: "sm_discover",
+  sm_explore: "sm_discover",
+  explore: "sm_discover",
+  related: "sm_related_files",
+  find_related: "sm_related_files",
+  session_summary: "sm_session_summary",
+  summary: "sm_session_summary",
+  // --- Save/Load context (old MCP server) ---
+  sm_save: "save_context",
+  sm_context_save: "save_context",
+  store_context: "save_context",
+  sm_load: "load_context",
+  sm_context_load: "load_context",
+  retrieve_context: "load_context",
+  // --- Linear tools ---
+  linear_issues: "linear_get_tasks",
+  linear_list: "linear_get_tasks",
+  get_linear_tasks: "linear_get_tasks",
+  linear_update: "linear_update_task",
+  update_linear: "linear_update_task",
+  linear_comment: "linear_create_comment",
+  comment_on_issue: "linear_create_comment",
+  linear_comments: "linear_list_comments",
+  // --- Trace tools ---
+  traces: "get_traces",
+  sm_traces: "get_traces",
+  list_traces: "get_traces",
+  trace_stats: "get_trace_statistics",
+  trace_statistics: "get_trace_statistics",
+  // --- Smart context ---
+  smart: "smart_context",
+  sm_smart: "smart_context",
+  intelligent_context: "smart_context",
+  sm_summary: "get_summary",
+  project_summary: "get_summary",
+  // --- Planning tools ---
+  // --- Pending tools ---
+  pending: "pending_list",
+  list_pending: "pending_list",
+  clear_pending: "pending_clear",
+  show_pending: "pending_show",
+  // --- Edit tools ---
+  fuzzy_edit: "sm_edit",
+  edit: "sm_edit",
+  sm_fuzzy_edit: "sm_edit",
+  // --- Digest tools ---
+  digest: "sm_digest",
+  activity_digest: "sm_digest",
+  daily_digest: "sm_digest",
+  // --- Desire paths ---
+  desire_paths: "sm_desire_paths",
+  desires: "sm_desire_paths",
+  failed_tools: "sm_desire_paths",
+  // --- Provenant tools ---
+  decision_search: "provenant_search",
+  search_decisions: "provenant_search",
+  log_decision_graph: "provenant_log",
+  decision_log: "provenant_log",
+  decision_status: "provenant_status",
+  graph_status: "provenant_status",
+  contradictions: "provenant_contradictions",
+  conflicts: "provenant_contradictions",
+  resolve: "provenant_resolve",
+  resolve_contradiction: "provenant_resolve"
+};
+const PARAM_ALIASES = {
+  // Agents often send `query` for search-like tools
+  sm_search: {
+    search_term: "query",
+    search: "query",
+    text: "query",
+    q: "query",
+    max: "limit",
+    max_results: "limit",
+    count: "limit"
+  },
+  sm_discover: {
+    search: "query",
+    q: "query",
+    search_query: "query",
+    max: "maxFiles",
+    max_files: "maxFiles",
+    limit: "maxFiles",
+    include: "includePatterns",
+    exclude: "excludePatterns"
+  },
+  get_context: {
+    search: "query",
+    q: "query",
+    text: "query",
+    max: "limit",
+    max_results: "limit",
+    count: "limit"
+  },
+  smart_context: {
+    search: "query",
+    q: "query",
+    tokens: "tokenBudget",
+    token_budget: "tokenBudget",
+    max_tokens: "tokenBudget",
+    budget: "tokenBudget",
+    refresh: "forceRefresh",
+    force: "forceRefresh"
+  },
+  get_active_tasks: {
+    state: "status",
+    max: "limit",
+    max_results: "limit",
+    count: "limit",
+    query: "search",
+    q: "search"
+  },
+  linear_get_tasks: {
+    status: "state",
+    max: "limit",
+    max_results: "limit",
+    count: "limit",
+    q: "search",
+    query: "search",
+    team: "team_id",
+    assignee: "assignee_id"
+  },
+  add_decision: {
+    text: "content",
+    decision: "content",
+    value: "content",
+    kind: "type",
+    category: "type"
+  },
+  add_anchor: {
+    content: "text",
+    value: "text",
+    anchor: "text",
+    kind: "type",
+    category: "type",
+    importance: "priority",
+    weight: "priority"
+  },
+  start_frame: {
+    title: "name",
+    goal: "name",
+    label: "name",
+    kind: "type",
+    frame_type: "type"
+  },
+  create_task: {
+    name: "title",
+    goal: "title",
+    label: "title",
+    desc: "description",
+    detail: "description",
+    details: "description"
+  },
+  sm_desire_paths: {
+    type: "category",
+    kind: "category",
+    max: "limit",
+    max_results: "limit",
+    lookback: "days",
+    period: "days"
+  },
+  provenant_search: {
+    text: "query",
+    search: "query",
+    q: "query",
+    max: "limit",
+    max_results: "limit",
+    from: "since",
+    after: "since",
+    by: "actor",
+    who: "actor"
+  },
+  provenant_log: {
+    decision: "content",
+    text: "content",
+    value: "content",
+    by: "actor",
+    who: "actor",
+    why: "reasoning",
+    reason: "reasoning",
+    rationale: "reasoning"
+  },
+  sm_edit: {
+    path: "file_path",
+    file: "file_path",
+    find: "old_string",
+    search: "old_string",
+    replace: "new_string",
+    replacement: "new_string"
+  },
+  sm_digest: {
+    time: "period",
+    range: "period",
+    timeframe: "period"
+  },
+  get_summary: {
+    refresh: "forceRefresh",
+    force: "forceRefresh"
+  }
+};
+function resolveToolAlias(name) {
+  const alias = TOOL_ALIASES[name];
+  if (alias) {
+    return { canonicalName: alias, wasAlias: true, originalName: name };
+  }
+  return { canonicalName: name, wasAlias: false, originalName: name };
+}
+function resolveParamAliases(toolName, params) {
+  const aliases = PARAM_ALIASES[toolName];
+  if (!aliases) {
+    return { resolvedParams: { ...params }, renames: {} };
+  }
+  const resolved = {};
+  const renames = {};
+  for (const [key, value] of Object.entries(params)) {
+    if (!aliases[key]) {
+      resolved[key] = value;
+    }
+  }
+  for (const [key, value] of Object.entries(params)) {
+    const canonicalKey = aliases[key];
+    if (canonicalKey && !(canonicalKey in resolved)) {
+      resolved[canonicalKey] = value;
+      renames[key] = canonicalKey;
+    }
+  }
+  return { resolvedParams: resolved, renames };
+}
+function getAliasesForTool(canonicalName) {
+  return Object.entries(TOOL_ALIASES).filter(([, target]) => target === canonicalName).map(([alias]) => alias);
+}
+function getToolsWithAliases() {
+  return Array.from(new Set(Object.values(TOOL_ALIASES)));
+}
+function getAliasRegistry() {
+  return TOOL_ALIASES;
+}
+function getParamAliasRegistry() {
+  return PARAM_ALIASES;
+}
+export {
+  getAliasRegistry,
+  getAliasesForTool,
+  getParamAliasRegistry,
+  getToolsWithAliases,
+  resolveParamAliases,
+  resolveToolAlias
+};