basicmachines-co-basic-memory/integrations/openclaw/tools/list-memory-projects.ts

import { Type } from "@sinclair/typebox"
import type { OpenClawPluginApi } from "openclaw/plugin-sdk/plugin-entry"
import type { BmClient, ProjectListResult } from "../bm-client.ts"
import { log } from "../logger.ts"

function normalizeProject(project: ProjectListResult) {
  return {
    name: project.name,
    path: project.path,
    display_name: project.display_name ?? null,
    is_private: project.is_private === true,
    is_default: project.is_default === true || project.isDefault === true,
    workspace_name: project.workspace_name ?? null,
    workspace_slug: project.workspace_slug ?? null,
    workspace_type: project.workspace_type ?? null,
    workspace_tenant_id: project.workspace_tenant_id ?? null,
  }
}

export function registerProjectListTool(
  api: OpenClawPluginApi,
  client: BmClient,
): void {
  api.registerTool(
    {
      name: "list_memory_projects",
      label: "List Projects",
      description: "List all Basic Memory projects accessible to this agent",
      parameters: Type.Object({
        workspace: Type.Optional(
          Type.String({
            description: "Filter by workspace name, slug, or tenant_id",
          }),
        ),
      }),
      async execute(_toolCallId: string, params: { workspace?: string }) {
        log.debug(`list_memory_projects: workspace="${params.workspace ?? ""}"`)

        try {
          const projects = await client.listProjects(params.workspace)
          const normalized = projects.map(normalizeProject)

          if (normalized.length === 0) {
            return {
              content: [
                {
                  type: "text" as const,
                  text: "No Basic Memory projects found.",
                },
              ],
              details: {
                count: 0,
                projects: [],
              },
            }
          }

          const text = normalized
            .map((project, idx) => {
              const defaultSuffix = project.is_default ? " (default)" : ""
              const displayLine = project.display_name
                ? `\n   Display Name: ${project.display_name}`
                : ""
              return `${idx + 1}. **${project.name}**${defaultSuffix}\n   Path: ${project.path}\n   Private: ${project.is_private}${displayLine}`
            })
            .join("\n\n")

          return {
            content: [
              {
                type: "text" as const,
                text: `Found ${normalized.length} project(s):\n\n${text}`,
              },
            ],
            details: {
              count: normalized.length,
              projects: normalized,
            },
          }
        } catch (err) {
          log.error("list_memory_projects failed", err)
          return {
            content: [
              {
                type: "text" as const,
                text: "Failed to list Basic Memory projects. Is Basic Memory running? Check logs for details.",
              },
            ],
            details: {
              count: 0,
              projects: [],
              workspace: params.workspace ?? null,
              error: "list_memory_projects_failed",
            },
          }
        }
      },
    },
    { name: "list_memory_projects" },
  )
}