@fml-inc/fml 0.1.2 → 0.2.0

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "fml",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "FML agent tools for Claude Code",
   "mcpServers": {
     "fml": {

package/dist/{chunk-I5BHNW37.js → chunk-BOREGHA6.js}

@@ -130,6 +130,42 @@ function createApiClient(token) {
         return { ok: false, error: msg };
       }
     },
+    // ── Tool catalog ─────────────────────────────────────────────────────
+    async listTools(pluginVersion) {
+      try {
+        if (isServiceToken) {
+          const url = new URL(`${getSiteUrl()}/api/tools/list`);
+          if (pluginVersion) url.searchParams.set("pluginVersion", pluginVersion);
+          const res = await fetch(url.toString(), {
+            headers: { Authorization: `Bearer ${token}` }
+          });
+          const text = await res.text();
+          let data;
+          try {
+            data = JSON.parse(text);
+          } catch {
+            throw new Error(`HTTP ${res.status}: ${text.slice(0, 200)}`);
+          }
+          if (!data.ok || !data.descriptors) {
+            throw new Error(data.error ?? `HTTP ${res.status}`);
+          }
+          return data.descriptors;
+        }
+        const client = await getClient();
+        return await client.query(
+          ref("user/plugin_tools:listTools"),
+          pluginVersion ? { pluginVersion } : {}
+        );
+      } catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        if (msg.includes("Unauthorized") || msg.includes("not authenticated")) {
+          throw new Error(
+            "Authentication expired. Run `fml login` to sign in again, then restart Claude Code."
+          );
+        }
+        throw err;
+      }
+    },
     // ── Repo resolution ──────────────────────────────────────────────────
     async resolveRepo(orgSlug, repoFullName) {
       const client = await getClient();
@@ -182,4 +218,4 @@ export {
   createApiClient,
   getAuthenticatedClient
 };
-//# sourceMappingURL=chunk-I5BHNW37.js.map
+//# sourceMappingURL=chunk-BOREGHA6.js.map

package/dist/chunk-BOREGHA6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/native-check.ts","../src/convex-client.ts"],"sourcesContent":["import { createRequire } from \"node:module\";\nimport { execSync } from \"node:child_process\";\nimport { rmSync } from \"node:fs\";\nimport { dirname, join } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\n/**\n * Verify that better-sqlite3's native addon matches the running Node version.\n * If mismatched (e.g. user upgraded Node), attempt an automatic rebuild.\n * Call this before any code that imports better-sqlite3.\n */\nexport function ensureNativeModules(): void {\n  const require = createRequire(import.meta.url);\n  try {\n    require(\"better-sqlite3\");\n  } catch (err) {\n    const msg = err instanceof Error ? err.message : \"\";\n    if (!msg.includes(\"NODE_MODULE_VERSION\")) {\n      throw err;\n    }\n\n    console.error(\n      \"[fml] better-sqlite3 was compiled for a different Node.js version, rebuilding...\",\n    );\n\n    const pkgRoot = join(dirname(fileURLToPath(import.meta.url)), \"..\");\n\n    // Remove stale build directory to avoid EEXIST errors from node-gyp\n    const sqlitePath = dirname(require.resolve(\"better-sqlite3/package.json\"));\n    rmSync(join(sqlitePath, \"build\"), { recursive: true, force: true });\n\n    try {\n      execSync(\"npm rebuild better-sqlite3\", {\n        cwd: pkgRoot,\n        stdio: \"inherit\",\n        timeout: 60_000,\n      });\n      console.error(\"[fml] Rebuild complete.\");\n    } catch {\n      console.error(\n        \"[fml] Automatic rebuild failed. Please run manually:\\n\" +\n          `  cd ${pkgRoot} && rm -rf node_modules/better-sqlite3/build && npm rebuild better-sqlite3`,\n      );\n      process.exit(1);\n    }\n  }\n}\n","import type { FunctionReference } from \"convex/server\";\nimport { resolveRepoFromCwd } from \"@fml-inc/panopticon/repo\";\nimport { getSelectedOrg, getValidToken } from \"./auth/token-store.js\";\nimport { CONVEX_URL } from \"./config.js\";\nimport type {\n  RepoConfigSnapshotDetail,\n  RepoConfigSnapshotSummary,\n  ResolvedRepo,\n  UserConfigSnapshotDetail,\n  UserConfigSnapshotSummary,\n} from \"./types.js\";\n\n// ── Shared plumbing ─────────────────────────────────────────────────────────\n\nexport type ToolCategory =\n  | \"messages\"\n  | \"slack\"\n  | \"skills\"\n  | \"analysis\"\n  | \"integrations\"\n  | \"engineering\"\n  | \"memory\"\n  | \"automations\"\n  | \"amplitude\"\n  | \"posthog\"\n  | \"meta-ads\";\n\nexport interface PublicToolDescriptor {\n  name: string;\n  description: string;\n  inputSchema: Record<string, unknown>;\n  category?: ToolCategory;\n  experimental?: boolean;\n}\n\nexport interface ToolResult {\n  ok: boolean;\n  result?: unknown;\n  error?: string;\n}\n\nexport interface OrgInfo {\n  _id: string;\n  name: string;\n  slug?: string;\n  repos?: Array<{\n    _id: string;\n    fullName: string;\n    owner: string;\n    name: string;\n    private: boolean;\n  }>;\n}\n\nfunction ref<T extends \"query\" | \"mutation\" | \"action\">(\n  path: string,\n): FunctionReference<T> {\n  return path as unknown as FunctionReference<T>;\n}\n\n// ── API client factory ──────────────────────────────────────────────────────\n\nexport function createApiClient(token: string) {\n  const isServiceToken = token.startsWith(\"fml_st_\");\n\n  let clientPromise: Promise<{\n    query: <T>(\n      ref: FunctionReference<\"query\">,\n      args: Record<string, unknown>,\n    ) => Promise<T>;\n    mutation: <T>(\n      ref: FunctionReference<\"mutation\">,\n      args: Record<string, unknown>,\n    ) => Promise<T>;\n    action: <T>(\n      ref: FunctionReference<\"action\">,\n      args: Record<string, unknown>,\n    ) => Promise<T>;\n  }> | null = null;\n\n  function getClient() {\n    if (!clientPromise) {\n      clientPromise = import(\"convex/browser\").then(({ ConvexHttpClient }) => {\n        const client = new ConvexHttpClient(CONVEX_URL);\n        client.setAuth(token);\n        return client;\n      });\n    }\n    return clientPromise;\n  }\n\n  /**\n   * Derive the Convex site URL (HTTP actions) from the cloud URL.\n   * Convex uses paired domains: *.convex.cloud for client APIs,\n   * *.convex.site for HTTP actions. This is a stable Convex convention.\n   */\n  function getSiteUrl(): string {\n    return CONVEX_URL.replace(\".convex.cloud\", \".convex.site\").replace(\n      /\\/$/,\n      \"\",\n    );\n  }\n\n  return {\n    // ── Orgs ──────────────────────────────────────────────────────────────\n\n    async queryOrgs(): Promise<OrgInfo[]> {\n      if (isServiceToken) {\n        // Service tokens can't call Convex actions directly — org is embedded in the token\n        return [];\n      }\n      const client = await getClient();\n      return await client.query(ref(\"user/plugin:getMyOrgsAndRepos\"), {});\n    },\n\n    // ── Tool gateway ─────────────────────────────────────────────────────\n\n    async callBackend(\n      toolName: string,\n      args: Record<string, unknown>,\n      opts?: { org?: string },\n    ): Promise<ToolResult> {\n      try {\n        if (isServiceToken) {\n          // Service token path: POST to HTTP endpoint (Convex can't validate non-JWT tokens)\n          // Thread user identity: sandbox agents set FML_USER_EXTERNAL_ID;\n          // device-flow logins fall back to the id stashed on the stored token\n          // so tools can execute with the real user context even though the\n          // token's actAsExternalId is the namespaced system:cli:* string.\n          const { readTokens } = await import(\"./auth/token-store.js\");\n          const userExternalId =\n            process.env.FML_USER_EXTERNAL_ID ?? readTokens()?.user.id;\n          const res = await fetch(`${getSiteUrl()}/api/tools/execute`, {\n            method: \"POST\",\n            headers: {\n              \"Content-Type\": \"application/json\",\n              Authorization: `Bearer ${token}`,\n            },\n            body: JSON.stringify({\n              toolName,\n              args,\n              ...(userExternalId && { userExternalId }),\n            }),\n          });\n          const text = await res.text();\n          let data: ToolResult;\n          try {\n            data = JSON.parse(text) as ToolResult;\n          } catch {\n            return {\n              ok: false,\n              error: `HTTP ${res.status}: ${text.slice(0, 200)}`,\n            };\n          }\n          if (!res.ok && !data.error) {\n            return { ok: false, error: `HTTP ${res.status}` };\n          }\n          return data;\n        }\n\n        // JWT path: standard Convex action\n        const client = await getClient();\n        const actionArgs: Record<string, unknown> = { toolName, args };\n        // Explicit org > stored org selection > repo-based inference\n        const org = opts?.org ?? getSelectedOrg();\n        if (org) actionArgs.org = org;\n        const repo = resolveRepoFromCwd(process.cwd());\n        if (repo) actionArgs.repo = repo.repo;\n\n        const result = await client.action(\n          ref<\"action\">(\"user/tool_gateway:executeTool\"),\n          actionArgs,\n        );\n        return { ok: true, result };\n      } catch (err) {\n        const msg = err instanceof Error ? err.message : String(err);\n        if (msg.includes(\"Unauthorized\") || msg.includes(\"not authenticated\")) {\n          return {\n            ok: false,\n            error:\n              \"Authentication expired. Run `fml login` to sign in again, then restart Claude Code.\",\n          };\n        }\n        return { ok: false, error: msg };\n      }\n    },\n\n    // ── Tool catalog ─────────────────────────────────────────────────────\n\n    async listTools(pluginVersion?: string): Promise<PublicToolDescriptor[]> {\n      try {\n        if (isServiceToken) {\n          const url = new URL(`${getSiteUrl()}/api/tools/list`);\n          if (pluginVersion) url.searchParams.set(\"pluginVersion\", pluginVersion);\n          const res = await fetch(url.toString(), {\n            headers: { Authorization: `Bearer ${token}` },\n          });\n          const text = await res.text();\n          let data: { ok: boolean; descriptors?: PublicToolDescriptor[]; error?: string };\n          try {\n            data = JSON.parse(text) as typeof data;\n          } catch {\n            throw new Error(`HTTP ${res.status}: ${text.slice(0, 200)}`);\n          }\n          if (!data.ok || !data.descriptors) {\n            throw new Error(data.error ?? `HTTP ${res.status}`);\n          }\n          return data.descriptors;\n        }\n\n        const client = await getClient();\n        return await client.query<PublicToolDescriptor[]>(\n          ref<\"query\">(\"user/plugin_tools:listTools\"),\n          pluginVersion ? { pluginVersion } : {},\n        );\n      } catch (err) {\n        const msg = err instanceof Error ? err.message : String(err);\n        if (msg.includes(\"Unauthorized\") || msg.includes(\"not authenticated\")) {\n          throw new Error(\n            \"Authentication expired. Run `fml login` to sign in again, then restart Claude Code.\",\n          );\n        }\n        throw err;\n      }\n    },\n\n    // ── Repo resolution ──────────────────────────────────────────────────\n\n    async resolveRepo(\n      orgSlug: string,\n      repoFullName: string,\n    ): Promise<ResolvedRepo | null> {\n      const client = await getClient();\n      return await client.query(ref(\"user/cli:resolveRepo\"), {\n        orgSlug,\n        repoFullName,\n      });\n    },\n\n    // ── Config snapshots ─────────────────────────────────────────────────\n\n    async listUserConfigSnapshots(\n      orgSlug: string,\n    ): Promise<UserConfigSnapshotSummary[]> {\n      const client = await getClient();\n      const result = await client.query<UserConfigSnapshotSummary[] | null>(\n        ref(\"user/config_snapshots:listUserSnapshots\"),\n        { orgSlug },\n      );\n      return result ?? [];\n    },\n\n    async getUserConfigDetail(\n      orgSlug: string,\n      githubUsername: string,\n    ): Promise<UserConfigSnapshotDetail | null> {\n      const client = await getClient();\n      return await client.query(ref(\"user/config_snapshots:getUserDetail\"), {\n        orgSlug,\n        githubUsername,\n      });\n    },\n\n    async listRepoConfigSnapshots(\n      orgSlug: string,\n      repository?: string,\n    ): Promise<RepoConfigSnapshotSummary[]> {\n      const client = await getClient();\n      const result = await client.query<RepoConfigSnapshotSummary[] | null>(\n        ref(\"user/config_snapshots:listRepoSnapshots\"),\n        { orgSlug, repository },\n      );\n      return result ?? [];\n    },\n\n    async getRepoConfigDetail(\n      orgSlug: string,\n      repository: string,\n    ): Promise<RepoConfigSnapshotDetail | null> {\n      const client = await getClient();\n      return await client.query(ref(\"user/config_snapshots:getRepoDetail\"), {\n        orgSlug,\n        repository,\n      });\n    },\n  };\n}\n\n// ── Convenience: auto-authenticated client ──────────────────────────────────\n\n/**\n * Create an API client using the stored auth token.\n * Returns null if not authenticated.\n */\nexport async function getAuthenticatedClient() {\n  const token = await getValidToken();\n  if (!token) return null;\n  return createApiClient(token);\n}\n"],"mappings":"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","names":["require"]}

package/dist/{chunk-YIWT7BWN.js → chunk-NFC24I3N.js}

@@ -2,7 +2,7 @@ import {
   SYNC_PID_FILE,
   isDaemonRunning,
   panopticonExec
-} from "./chunk-ZA4RG25C.js";
+} from "./chunk-ZKHH6EYQ.js";
 
 // src/commands/daemon.ts
 function parsePanopticonRunning() {
@@ -30,4 +30,4 @@ export {
   handleStart,
   handleStop
 };
-//# sourceMappingURL=chunk-YIWT7BWN.js.map
+//# sourceMappingURL=chunk-NFC24I3N.js.map

package/dist/{chunk-ZA4RG25C.js → chunk-ZKHH6EYQ.js}

@@ -40,7 +40,7 @@ function panopticonExec(...argsAndOpts) {
   const bin = resolvePanopticonBin();
   if (!bin) return { ok: false, stdout: "panopticon binary not found" };
   try {
-    const stdout = execFileSync("node", [bin, ...args], {
+    const stdout = execFileSync(bin, args, {
       encoding: "utf-8",
       timeout
     });
@@ -58,4 +58,4 @@ export {
   resolvePanopticonBin,
   panopticonExec
 };
-//# sourceMappingURL=chunk-ZA4RG25C.js.map
+//# sourceMappingURL=chunk-ZKHH6EYQ.js.map

package/dist/{chunk-ZA4RG25C.js.map → chunk-ZKHH6EYQ.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/daemon-utils.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport path from \"node:path\";\nimport { execFileSync } from \"node:child_process\";\nimport { FML_DATA_DIR, FML_LOG_DIR } from \"./dirs.js\";\n\nexport const SYNC_PID_FILE = path.join(FML_DATA_DIR, \"sync.pid\");\nexport const SYNC_LOG_FILE = path.join(FML_LOG_DIR, \"sync.log\");\n\nexport function isDaemonRunning(pidFile: string): {\n  running: boolean;\n  pid: number | null;\n} {\n  if (!fs.existsSync(pidFile)) return { running: false, pid: null };\n  const pid = parseInt(fs.readFileSync(pidFile, \"utf-8\").trim(), 10);\n  try {\n    process.kill(pid, 0);\n    return { running: true, pid };\n  } catch {\n    return { running: false, pid };\n  }\n}\n\n/** Resolve the panopticon CLI binary from PATH (globally installed). */\nexport function resolvePanopticonBin(): string | null {\n  try {\n    const result = execFileSync(\"which\", [\"panopticon\"], {\n      encoding: \"utf-8\",\n      timeout: 5_000,\n    }).trim();\n    if (result) return result;\n  } catch {}\n\n  return null;\n}\n\n/** Run a panopticon CLI command and return stdout. */\nexport function panopticonExec(...args: string[]): {\n  ok: boolean;\n  stdout: string;\n};\nexport function panopticonExec(\n  ...argsAndOpts: [...string[], { timeout?: number }]\n): { ok: boolean; stdout: string };\nexport function panopticonExec(\n  ...argsAndOpts: Array<string | { timeout?: number }>\n): {\n  ok: boolean;\n  stdout: string;\n} {\n  let timeout = 10_000;\n  const args: string[] = [];\n  for (const a of argsAndOpts) {\n    if (typeof a === \"string\") args.push(a);\n    else timeout = a.timeout ?? timeout;\n  }\n  const bin = resolvePanopticonBin();\n  if (!bin) return { ok: false, stdout: \"panopticon binary not found\" };\n  try {\n    const stdout = execFileSync(\"node\", [bin, ...args], {\n      encoding: \"utf-8\",\n      timeout,\n    });\n    return { ok: true, stdout };\n  } catch (err: unknown) {\n    const e = err as { stdout?: string; stderr?: string; status?: number };\n    return { ok: false, stdout: (e.stdout ?? \"\") + (e.stderr ?? \"\") };\n  }\n}\n"],"mappings":";;;;;;AAAA,OAAO,QAAQ;AACf,OAAO,UAAU;AACjB,SAAS,oBAAoB;AAGtB,IAAM,gBAAgB,KAAK,KAAK,cAAc,UAAU;AACxD,IAAM,gBAAgB,KAAK,KAAK,aAAa,UAAU;AAEvD,SAAS,gBAAgB,SAG9B;AACA,MAAI,CAAC,GAAG,WAAW,OAAO,EAAG,QAAO,EAAE,SAAS,OAAO,KAAK,KAAK;AAChE,QAAM,MAAM,SAAS,GAAG,aAAa,SAAS,OAAO,EAAE,KAAK,GAAG,EAAE;AACjE,MAAI;AACF,YAAQ,KAAK,KAAK,CAAC;AACnB,WAAO,EAAE,SAAS,MAAM,IAAI;AAAA,EAC9B,QAAQ;AACN,WAAO,EAAE,SAAS,OAAO,IAAI;AAAA,EAC/B;AACF;AAGO,SAAS,uBAAsC;AACpD,MAAI;AACF,UAAM,SAAS,aAAa,SAAS,CAAC,YAAY,GAAG;AAAA,MACnD,UAAU;AAAA,MACV,SAAS;AAAA,IACX,CAAC,EAAE,KAAK;AACR,QAAI,OAAQ,QAAO;AAAA,EACrB,QAAQ;AAAA,EAAC;AAET,SAAO;AACT;AAUO,SAAS,kBACX,aAIH;AACA,MAAI,UAAU;AACd,QAAM,OAAiB,CAAC;AACxB,aAAW,KAAK,aAAa;AAC3B,QAAI,OAAO,MAAM,SAAU,MAAK,KAAK,CAAC;AAAA,QACjC,WAAU,EAAE,WAAW;AAAA,EAC9B;AACA,QAAM,MAAM,qBAAqB;AACjC,MAAI,CAAC,IAAK,QAAO,EAAE,IAAI,OAAO,QAAQ,8BAA8B;AACpE,MAAI;AACF,UAAM,SAAS,aAAa,QAAQ,CAAC,KAAK,GAAG,IAAI,GAAG;AAAA,MAClD,UAAU;AAAA,MACV;AAAA,IACF,CAAC;AACD,WAAO,EAAE,IAAI,MAAM,OAAO;AAAA,EAC5B,SAAS,KAAc;AACrB,UAAM,IAAI;AACV,WAAO,EAAE,IAAI,OAAO,SAAS,EAAE,UAAU,OAAO,EAAE,UAAU,IAAI;AAAA,EAClE;AACF;","names":[]}
+{"version":3,"sources":["../src/daemon-utils.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport path from \"node:path\";\nimport { execFileSync } from \"node:child_process\";\nimport { FML_DATA_DIR, FML_LOG_DIR } from \"./dirs.js\";\n\nexport const SYNC_PID_FILE = path.join(FML_DATA_DIR, \"sync.pid\");\nexport const SYNC_LOG_FILE = path.join(FML_LOG_DIR, \"sync.log\");\n\nexport function isDaemonRunning(pidFile: string): {\n  running: boolean;\n  pid: number | null;\n} {\n  if (!fs.existsSync(pidFile)) return { running: false, pid: null };\n  const pid = parseInt(fs.readFileSync(pidFile, \"utf-8\").trim(), 10);\n  try {\n    process.kill(pid, 0);\n    return { running: true, pid };\n  } catch {\n    return { running: false, pid };\n  }\n}\n\n/** Resolve the panopticon CLI binary from PATH (globally installed). */\nexport function resolvePanopticonBin(): string | null {\n  try {\n    const result = execFileSync(\"which\", [\"panopticon\"], {\n      encoding: \"utf-8\",\n      timeout: 5_000,\n    }).trim();\n    if (result) return result;\n  } catch {}\n\n  return null;\n}\n\n/** Run a panopticon CLI command and return stdout. */\nexport function panopticonExec(...args: string[]): {\n  ok: boolean;\n  stdout: string;\n};\nexport function panopticonExec(\n  ...argsAndOpts: [...string[], { timeout?: number }]\n): { ok: boolean; stdout: string };\nexport function panopticonExec(\n  ...argsAndOpts: Array<string | { timeout?: number }>\n): {\n  ok: boolean;\n  stdout: string;\n} {\n  let timeout = 10_000;\n  const args: string[] = [];\n  for (const a of argsAndOpts) {\n    if (typeof a === \"string\") args.push(a);\n    else timeout = a.timeout ?? timeout;\n  }\n  const bin = resolvePanopticonBin();\n  if (!bin) return { ok: false, stdout: \"panopticon binary not found\" };\n  try {\n    const stdout = execFileSync(bin, args, {\n      encoding: \"utf-8\",\n      timeout,\n    });\n    return { ok: true, stdout };\n  } catch (err: unknown) {\n    const e = err as { stdout?: string; stderr?: string; status?: number };\n    return { ok: false, stdout: (e.stdout ?? \"\") + (e.stderr ?? \"\") };\n  }\n}\n"],"mappings":";;;;;;AAAA,OAAO,QAAQ;AACf,OAAO,UAAU;AACjB,SAAS,oBAAoB;AAGtB,IAAM,gBAAgB,KAAK,KAAK,cAAc,UAAU;AACxD,IAAM,gBAAgB,KAAK,KAAK,aAAa,UAAU;AAEvD,SAAS,gBAAgB,SAG9B;AACA,MAAI,CAAC,GAAG,WAAW,OAAO,EAAG,QAAO,EAAE,SAAS,OAAO,KAAK,KAAK;AAChE,QAAM,MAAM,SAAS,GAAG,aAAa,SAAS,OAAO,EAAE,KAAK,GAAG,EAAE;AACjE,MAAI;AACF,YAAQ,KAAK,KAAK,CAAC;AACnB,WAAO,EAAE,SAAS,MAAM,IAAI;AAAA,EAC9B,QAAQ;AACN,WAAO,EAAE,SAAS,OAAO,IAAI;AAAA,EAC/B;AACF;AAGO,SAAS,uBAAsC;AACpD,MAAI;AACF,UAAM,SAAS,aAAa,SAAS,CAAC,YAAY,GAAG;AAAA,MACnD,UAAU;AAAA,MACV,SAAS;AAAA,IACX,CAAC,EAAE,KAAK;AACR,QAAI,OAAQ,QAAO;AAAA,EACrB,QAAQ;AAAA,EAAC;AAET,SAAO;AACT;AAUO,SAAS,kBACX,aAIH;AACA,MAAI,UAAU;AACd,QAAM,OAAiB,CAAC;AACxB,aAAW,KAAK,aAAa;AAC3B,QAAI,OAAO,MAAM,SAAU,MAAK,KAAK,CAAC;AAAA,QACjC,WAAU,EAAE,WAAW;AAAA,EAC9B;AACA,QAAM,MAAM,qBAAqB;AACjC,MAAI,CAAC,IAAK,QAAO,EAAE,IAAI,OAAO,QAAQ,8BAA8B;AACpE,MAAI;AACF,UAAM,SAAS,aAAa,KAAK,MAAM;AAAA,MACrC,UAAU;AAAA,MACV;AAAA,IACF,CAAC;AACD,WAAO,EAAE,IAAI,MAAM,OAAO;AAAA,EAC5B,SAAS,KAAc;AACrB,UAAM,IAAI;AACV,WAAO,EAAE,IAAI,OAAO,SAAS,EAAE,UAAU,OAAO,EAAE,UAAU,IAAI;AAAA,EAClE;AACF;","names":[]}

package/dist/cli.js

@@ -3,7 +3,7 @@ import {
   createApiClient,
   ensureNativeModules,
   getAuthenticatedClient
-} from "./chunk-I5BHNW37.js";
+} from "./chunk-BOREGHA6.js";
 import {
   CONVEX_URL,
   DEFAULT_SYNC_URL,
@@ -27,10 +27,10 @@ import {
   handleStart,
   handleStop,
   parsePanopticonRunning
-} from "./chunk-YIWT7BWN.js";
+} from "./chunk-NFC24I3N.js";
 import {
   panopticonExec
-} from "./chunk-ZA4RG25C.js";
+} from "./chunk-ZKHH6EYQ.js";
 import {
   FML_DATA_DIR,
   FML_LOG_DIR
@@ -369,7 +369,7 @@ async function handleInstall() {
   const pluginRoot = getPluginRoot();
   console.log("Installing fml...\n");
   console.log("[1/5] Setting up panopticon...");
-  const { resolvePanopticonBin } = await import("./daemon-utils-LIG6K2MK.js");
+  const { resolvePanopticonBin } = await import("./daemon-utils-EUOTVCKL.js");
   let freshInstall = false;
   const bin = resolvePanopticonBin();
   let needsInstall = !bin;
@@ -689,7 +689,7 @@ function handleUninstall(opts) {
 // src/commands/update.ts
 import { execSync as execSync2 } from "child_process";
 async function handleUpdate() {
-  const currentVersion = true ? "0.1.2+c446035" : "unknown";
+  const currentVersion = true ? "0.2.0+beaba19" : "unknown";
   console.log(`Current: ${currentVersion}`);
   console.log("Updating via npm...\n");
   try {
@@ -1931,6 +1931,134 @@ async function handleConfigDetail(opts) {
   }
 }
 
+// src/commands/tools.ts
+import { readFileSync } from "fs";
+import path3 from "path";
+var pluginVersion = true ? "0.2.0+beaba19" : void 0;
+async function getApi() {
+  const api = await getAuthenticatedClient();
+  if (!api) {
+    console.error("Not authenticated. Run `fml login`.");
+    process.exit(1);
+  }
+  return api;
+}
+function levenshtein(a, b) {
+  if (a === b) return 0;
+  if (a.length === 0) return b.length;
+  if (b.length === 0) return a.length;
+  let prev = Array.from({ length: b.length + 1 }, (_, i) => i);
+  for (let i = 0; i < a.length; i++) {
+    const curr = [i + 1];
+    for (let j = 0; j < b.length; j++) {
+      const cost = a[i] === b[j] ? 0 : 1;
+      curr.push(Math.min(curr[j] + 1, prev[j + 1] + 1, prev[j] + cost));
+    }
+    prev = curr;
+  }
+  return prev[b.length];
+}
+function closestMatches(name, descriptors) {
+  const threshold = Math.max(2, Math.ceil(name.length * 0.4));
+  return descriptors.map((d) => ({
+    name: d.name,
+    // Substring match always beats fuzzy match.
+    score: d.name.includes(name) ? 0 : levenshtein(name, d.name)
+  })).filter((m) => m.score <= threshold).sort((a, b) => a.score - b.score).slice(0, 3).map((m) => m.name);
+}
+function findOrSuggestExit(name, descriptors) {
+  const descriptor = descriptors.find((d) => d.name === name);
+  if (descriptor) return descriptor;
+  console.error(`Unknown tool: ${name}`);
+  const suggestions = closestMatches(name, descriptors);
+  if (suggestions.length > 0) {
+    console.error(`Did you mean: ${suggestions.join(", ")}?`);
+  }
+  process.exit(1);
+}
+async function handleToolsList(opts) {
+  const api = await getApi();
+  let descriptors = await api.listTools(pluginVersion);
+  if (opts.category) {
+    descriptors = descriptors.filter((d) => d.category === opts.category);
+  }
+  if (opts.json) {
+    console.log(JSON.stringify(descriptors, null, 2));
+    return;
+  }
+  if (descriptors.length === 0) {
+    console.log("No tools found.");
+    return;
+  }
+  const nameW = Math.min(
+    40,
+    Math.max(...descriptors.map((d) => d.name.length), 4)
+  );
+  const catW = 14;
+  const header = "name".padEnd(nameW) + "  " + "category".padEnd(catW) + "  description";
+  const divider = "-".repeat(header.length);
+  console.log(header);
+  console.log(divider);
+  for (const d of descriptors) {
+    const cat = d.category ?? "";
+    const suffix = d.experimental ? " (experimental)" : "";
+    const desc = (d.description + suffix).slice(0, 80);
+    console.log(d.name.padEnd(nameW) + "  " + cat.padEnd(catW) + "  " + desc);
+  }
+}
+async function handleToolsDescribe(name, opts) {
+  const api = await getApi();
+  const descriptors = await api.listTools(pluginVersion);
+  const descriptor = findOrSuggestExit(name, descriptors);
+  if (opts.json) {
+    console.log(JSON.stringify(descriptor, null, 2));
+    return;
+  }
+  console.log(`Name:        ${descriptor.name}`);
+  if (descriptor.category) console.log(`Category:    ${descriptor.category}`);
+  if (descriptor.experimental) console.log(`Experimental: true`);
+  console.log(`
+Description:
+  ${descriptor.description}`);
+  console.log(`
+Input schema:
+${JSON.stringify(descriptor.inputSchema, null, 2)}`);
+}
+async function handleToolsCall(name, opts) {
+  if (opts.args !== void 0 && opts.file !== void 0) {
+    console.error("Error: --args and --file are mutually exclusive.");
+    process.exit(1);
+  }
+  const raw = opts.file ? (() => {
+    try {
+      return readFileSync(path3.resolve(opts.file), "utf8");
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      console.error(`Could not read args file: ${msg}`);
+      process.exit(1);
+    }
+  })() : opts.args ?? "{}";
+  let parsedArgs;
+  try {
+    parsedArgs = JSON.parse(raw);
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    console.error(
+      `Invalid JSON in ${opts.file ? "--file" : "--args"}: ${msg}`
+    );
+    process.exit(1);
+  }
+  const api = await getApi();
+  const descriptors = await api.listTools(pluginVersion);
+  findOrSuggestExit(name, descriptors);
+  const result = await api.callBackend(name, parsedArgs);
+  if (!result.ok) {
+    console.error(result.error || "Request failed");
+    process.exit(1);
+  }
+  console.log(JSON.stringify(result.result, null, 2));
+}
+
 // src/cli.ts
 ensureNativeModules();
 await initSentry();
@@ -1938,9 +2066,9 @@ if (process.argv.length <= 2 || process.argv.includes("--help") || process.argv.
   printBanner();
 }
 var program = new Command().name("fml").description("FML agent tools for Claude Code").version(
-  true ? "0.1.2+c446035" : "dev"
+  true ? "0.2.0+beaba19" : "dev"
 );
-program.command("tools", { hidden: true }).description("List all available CLI commands (including hidden agent tools)").action(() => {
+var tools = program.command("tools", { hidden: true }).description("List all available CLI commands (including hidden agent tools)").action(() => {
   function formatCmd(cmd, prefix = "") {
     const name = prefix ? `${prefix} ${cmd.name()}` : cmd.name();
     const args = cmd.registeredArguments.map((a) => a.required ? `<${a.name()}>` : `[${a.name()}]`).join(" ");
@@ -1959,6 +2087,9 @@ program.command("tools", { hidden: true }).description("List all available CLI c
   });
   console.log(lines.join("\n\n"));
 });
+tools.command("list").description("List backend tools available via the dynamic catalog").option("--category <category>", "Filter by category").option("--json", "Output as JSON").action((opts) => handleToolsList(opts));
+tools.command("describe").description("Show description and input schema for a backend tool").argument("<name>", "Tool name (e.g. integration-github)").option("--json", "Output as JSON").action((name, opts) => handleToolsDescribe(name, opts));
+tools.command("call").description("Invoke a backend tool by name with JSON args").argument("<name>", "Tool name").option("--args <json>", "Args as a JSON string (defaults to {})").option("--file <path>", "Path to a JSON file containing args").action((name, opts) => handleToolsCall(name, opts));
 program.command("install").description("Register plugin, hooks, and daemons").action(() => handleInstall());
 program.command("uninstall").description("Remove fml plugin, hooks, and optionally all data").option(
   "--target <target>",