@dinoxx/dinox-cli 1.0.1 → 1.0.3

package/README.md

@@ -115,6 +115,8 @@ dino auth status
 dino note search "AI"
 dino note search "AI" --days 7
 dino note search "AI" --from 2026-02-01 --to 2026-02-28
+dino note search "AI" --box "Inbox"
+dino note search --sql 'type = "crawl" AND zettel_boxes IN ("Inbox","Project")'
 ```
 
 创建笔记：
@@ -174,6 +176,7 @@ dino box add --name "Inbox" --description "用于存放待整理的想法和资
 
 ```bash
 dino prompt list
+dino prompt add --name "周报助手" --cmd "请基于本周笔记输出一份简洁周报"
 ```
 
 ## 5.5 配置
@@ -207,11 +210,6 @@ dino config set sync.timeoutMs 20000
 1. macOS: `~/Library/Application Support/dinox/config.json`
 2. Windows: `%APPDATA%\dinox\config.json`
 
-本地数据库：
-
-1. macOS: `~/Library/Application Support/dinox/powersync.sqlite`
-2. Windows: `%LOCALAPPDATA%\dinox\powersync.sqlite`
-
 ## 6.2 多行命令写法不同
 
 macOS / Linux（bash/zsh）用 `\` 续行：
@@ -269,7 +267,244 @@ dino box add "你的卡片盒"
 
 ---
 
-## 8. 查看帮助
+## 8. 完整命令参数参考
+
+## 8.1 全局参数（适用于 CLI）
+
+以下参数可放在命令前后使用，例如：`dino --json auth status`。
+
+| 参数 | 类型 | 说明 |
+| --- | --- | --- |
+| `--json` | flag | 输出 machine-readable YAML（仅被支持该参数的命令读取）。 |
+| `--offline` | flag | 跳过 connect/sync，仅用本地缓存（仅被支持该参数的命令读取）。 |
+| `--sync-timeout <ms>` | integer | 覆盖连接/同步超时毫秒，必须是正整数。 |
+| `--verbose` | flag | 预留 verbose 开关。 |
+
+## 8.2 `auth` 命令
+
+### `dino auth login <authorization>`
+
+保存授权信息并验证连接。
+
+| 参数 | 必填 | 说明 |
+| --- | --- | --- |
+| `<authorization>` | 是 | 完整 Authorization 头值，例如：`"Bearer <token>"` |
+
+支持全局参数：`--json`、`--sync-timeout`
+
+### `dino auth logout`
+
+清理已保存登录信息。
+
+| 选项 | 必填 | 说明 |
+| --- | --- | --- |
+| `--clear-local-db` | 否 | 同时删除本地 SQLite 数据库。 |
+
+### `dino auth status`
+
+查看当前登录与同步状态。
+
+支持全局参数：`--json`、`--offline`、`--sync-timeout`
+
+## 8.3 `sync` 命令
+
+### `dino sync`
+
+连接并执行同步。
+
+支持全局参数：`--json`、`--sync-timeout`
+
+## 8.4 `note` 命令
+
+### `dino note search [query]`
+
+按关键词/标签/创建时间搜索笔记。
+
+| 参数 | 必填 | 说明 |
+| --- | --- | --- |
+| `[query]` | 否 | 搜索关键词。可为空。 |
+
+| 选项 | 必填 | 说明 |
+| --- | --- | --- |
+| `--tags <expr>` | 否 | 标签表达式，支持 `AND` / `OR` / `NOT` 与括号。 |
+| `--from <date>` | 否 | 创建时间起点，支持 `YYYY-MM-DD` 或 ISO datetime。 |
+| `--to <date>` | 否 | 创建时间终点，支持 `YYYY-MM-DD` 或 ISO datetime。 |
+| `--days <n>` | 否 | 最近 N 天（按 `created_at`），不能与 `--from/--to` 同时使用。 |
+| `--box <string\|@file>` | 否 | 按卡片盒名称筛选（支持 JSON 数组或逗号/换行分隔）；会自动解析为 box id 查询。 |
+| `--sql <expr>` | 否 | SQL 风格条件表达式；仅支持字段 `id/content_md/summary/tags/zettel_boxes/created_at/type`，其中 `zettel_boxes` 按名称自动转 id。只支持只读 WHERE 条件（禁止 `INSERT/UPDATE/DELETE`、注释和多语句）。 |
+| `--include-deleted` | 否 | 包含软删除笔记。 |
+
+支持全局参数：`--offline`、`--sync-timeout`
+
+### `dino note get <id>`
+
+按 ID 获取笔记基础信息。
+
+| 参数 | 必填 | 说明 |
+| --- | --- | --- |
+| `<id>` | 是 | 笔记 ID。 |
+
+支持全局参数：`--json`、`--offline`、`--sync-timeout`
+
+### `dino note detail <id>`
+
+按 ID 获取笔记完整详情。
+
+| 参数 | 必填 | 说明 |
+| --- | --- | --- |
+| `<id>` | 是 | 笔记 ID。 |
+
+支持全局参数：`--offline`、`--sync-timeout`
+
+### `dino note create --title <string> --content <string|@file> [options]`
+
+创建笔记。
+
+| 选项 | 必填 | 说明 |
+| --- | --- | --- |
+| `--title <string>` | 是 | 笔记标题。 |
+| `--content <string|@file>` | 是 | Markdown 内容，可传 `@文件路径`。 |
+| `--type <note\|crawl>` | 否 | 笔记类型，默认 `crawl`。 |
+| `--tags <string\|@file>` | 否 | 标签列表（JSON 数组或逗号/换行分隔）。 |
+| `--zettel_boxes <string\|@file>` | 否 | 卡片盒名称列表（JSON 数组或逗号/换行分隔）。 |
+
+支持全局参数：`--json`、`--offline`、`--sync-timeout`
+
+### `dino note delete <id>`
+
+软删除笔记（`is_del=1`）。
+
+| 参数 | 必填 | 说明 |
+| --- | --- | --- |
+| `<id>` | 是 | 笔记 ID。 |
+
+支持全局参数：`--json`、`--offline`、`--sync-timeout`
+
+## 8.5 `tag` 命令
+
+### `dino tag list`
+
+列出标签。
+
+| 选项 | 必填 | 说明 |
+| --- | --- | --- |
+| `--json` | 否 | 输出 machine-readable YAML。 |
+| `--offline` | 否 | 跳过 connect/sync，仅用本地缓存。 |
+| `--sync-timeout <ms>` | 否 | 覆盖连接/同步超时毫秒。 |
+
+### `dino tag add [name] [options]`
+
+新增标签。
+
+| 参数 | 必填 | 说明 |
+| --- | --- | --- |
+| `[name]` | 否 | 标签名/路径（支持斜杠层级）。 |
+
+| 选项 | 必填 | 说明 |
+| --- | --- | --- |
+| `--name <string>` | 否 | 标签名/路径，可替代位置参数 `[name]`。 |
+| `--emoji <string>` | 否 | 标签 emoji。 |
+| `--json` | 否 | 输出 machine-readable YAML。 |
+| `--offline` | 否 | 跳过 connect/sync，仅用本地缓存。 |
+| `--sync-timeout <ms>` | 否 | 覆盖连接/同步超时毫秒。 |
+
+说明：`[name]` 与 `--name` 至少提供一个；若两者都提供且值不同会报错。
+
+## 8.6 `box` 命令
+
+### `dino box list`
+
+列出卡片盒。
+
+| 选项 | 必填 | 说明 |
+| --- | --- | --- |
+| `--offline` | 否 | 跳过 connect/sync，仅用本地缓存。 |
+| `--sync-timeout <ms>` | 否 | 覆盖连接/同步超时毫秒。 |
+
+### `dino box add [name] [options]`
+
+新增卡片盒。
+
+| 参数 | 必填 | 说明 |
+| --- | --- | --- |
+| `[name]` | 否 | 卡片盒名称。 |
+
+| 选项 | 必填 | 说明 |
+| --- | --- | --- |
+| `--name <string>` | 否 | 卡片盒名称，可替代位置参数 `[name]`。 |
+| `--description <string>` | 否 | 用途说明（可帮助 AI 路由笔记）。 |
+| `--color <string>` | 否 | 卡片盒颜色。 |
+| `--json` | 否 | 输出 machine-readable YAML。 |
+| `--offline` | 否 | 跳过 connect/sync，仅用本地缓存。 |
+| `--sync-timeout <ms>` | 否 | 覆盖连接/同步超时毫秒。 |
+
+说明：`[name]` 与 `--name` 至少提供一个；若两者都提供且值不同会报错。
+
+## 8.7 `prompt` 命令
+
+### `dino prompt list`
+
+列出 Prompt（`name` 与 `cmd`）。
+
+| 选项 | 必填 | 说明 |
+| --- | --- | --- |
+| `--offline` | 否 | 跳过 connect/sync，仅用本地缓存。 |
+| `--sync-timeout <ms>` | 否 | 覆盖连接/同步超时毫秒。 |
+
+### `dino prompt add [options]`
+
+新增 Prompt（写入 `c_cmd`）。
+
+| 选项 | 必填 | 说明 |
+| --- | --- | --- |
+| `--name <string>` | 是 | Prompt 名称。 |
+| `--cmd <string>` | 是 | Prompt 指令内容。 |
+| `--json` | 否 | 输出 machine-readable YAML。 |
+| `--offline` | 否 | 跳过 connect/sync，仅用本地缓存。 |
+| `--sync-timeout <ms>` | 否 | 覆盖连接/同步超时毫秒。 |
+
+## 8.8 `config` 命令
+
+### `dino config get [key]`
+
+读取配置（输出 YAML）。
+
+| 参数 | 必填 | 说明 |
+| --- | --- | --- |
+| `[key]` | 否 | 配置键（点路径）；不传则返回全部配置。 |
+
+可读 key：
+
+```text
+sync.timeoutMs
+```
+
+### `dino config set <key> <value>`
+
+写入配置。
+
+| 参数 | 必填 | 说明 |
+| --- | --- | --- |
+| `<key>` | 是 | 配置键（点路径）。 |
+| `<value>` | 是 | 配置值。 |
+
+可写 key：
+
+```text
+sync.timeoutMs    (必须为正整数)
+```
+
+## 8.9 `info` 命令
+
+### `dino info`
+
+显示 CLI 版本信息。
+
+支持全局参数：`--json`
+
+---
+
+## 9. 查看帮助
 
 随时可以看帮助：
 

package/dist/commands/auth/index.js

@@ -8,6 +8,7 @@ import { printYaml } from '../../utils/output.js';
 import { refreshAndPersistAuthIdentity } from '../../auth/userInfo.js';
 import { connectPowerSync, getStatusSnapshot } from '../../powersync/runtime.js';
 import { fetchCredentialsWithAuthorization } from '../../powersync/connector.js';
+import { runSingleSyncPass } from '../../powersync/syncPass.js';
 function parseSyncTimeoutMs(value) {
     if (typeof value !== 'string') {
         return undefined;
@@ -18,6 +19,12 @@ function parseSyncTimeoutMs(value) {
     }
     return Math.trunc(parsed);
 }
+async function removeSqliteArtifacts(dbPath) {
+    const artifacts = ['', '-wal', '-shm'];
+    for (const suffix of artifacts) {
+        await fs.rm(`${dbPath}${suffix}`, { force: true }).catch(() => undefined);
+    }
+}
 export function registerAuthCommands(program) {
     const auth = program
         .command('auth')
@@ -26,8 +33,7 @@ export function registerAuthCommands(program) {
         .command('login')
         .description('Save authorization token and verify PowerSync connectivity')
         .argument('<authorization>', 'full Authorization header value (e.g. "Bearer <token>")')
-        .option('--no-verify', 'skip credential exchange and initial sync')
-        .action(async (authorization, options, command) => {
+        .action(async (authorization, _options, command) => {
         const auth = authorization?.trim();
         if (!auth) {
             throw new DinoxError('Authorization token is required');
@@ -39,20 +45,6 @@ export function registerAuthCommands(program) {
         const globals = command.optsWithGlobals?.() ?? {};
         const timeoutMs = parseSyncTimeoutMs(globals.syncTimeout) ?? resolved.sync.timeoutMs;
         const jsonOutput = Boolean(globals.json);
-        if (!options.verify) {
-            const result = {
-                ok: true,
-                verified: false,
-                authorization: redactAuthorization(auth),
-            };
-            if (jsonOutput) {
-                printYaml(result);
-            }
-            else {
-                console.log('Login saved (verification skipped).');
-            }
-            return;
-        }
         // 1) Token exchange sanity check.
         await fetchCredentialsWithAuthorization({
             authorization: auth,
@@ -68,6 +60,7 @@ export function registerAuthCommands(program) {
             timeoutMs,
         });
         try {
+            await runSingleSyncPass(db, timeoutMs);
             const status = getStatusSnapshot(db);
             const result = {
                 ok: true,
@@ -110,7 +103,7 @@ export function registerAuthCommands(program) {
         await saveConfig(config);
         if (options.clearLocalDb) {
             const dbPath = getPowerSyncDbPath();
-            await fs.rm(dbPath, { force: true }).catch(() => undefined);
+            await removeSqliteArtifacts(dbPath);
         }
     });
     auth

package/dist/commands/config/index.d.ts

@@ -1,2 +1,3 @@
 import { Command } from 'commander';
+export declare function sanitizeConfigForDisplay(config: unknown): unknown;
 export declare function registerConfigCommands(program: Command): void;

package/dist/commands/config/index.js

@@ -1,10 +1,9 @@
 import { isConfigKey, isFixedConfigKey, isReadableConfigKey } from '../../config/keys.js';
-import { getConfigValue, loadConfig, setConfigValue } from '../../config/store.js';
-import { resolveConfig } from '../../config/resolve.js';
+import { getConfigValue, setConfigValue } from '../../config/store.js';
 import { redactAuthorization } from '../../utils/redact.js';
 import { DinoxError } from '../../utils/errors.js';
 import { printYaml } from '../../utils/output.js';
-function redactConfigForDisplay(config) {
+export function sanitizeConfigForDisplay(config) {
     if (!config || typeof config !== 'object' || Array.isArray(config)) {
         return config;
     }
@@ -13,16 +12,9 @@ function redactConfigForDisplay(config) {
     if (auth && typeof auth === 'object') {
         auth.authorization = redactAuthorization(auth.authorization);
     }
+    delete clone.powersync;
     return clone;
 }
-function getByPath(value, keyPath) {
-    return keyPath.split('.').reduce((current, segment) => {
-        if (!current || typeof current !== 'object') {
-            return undefined;
-        }
-        return current[segment];
-    }, value);
-}
 export function registerConfigCommands(program) {
     const configCmd = program.command('config').description('Read and write Dinox configuration');
     configCmd
@@ -33,13 +25,8 @@ export function registerConfigCommands(program) {
         if (key && !isReadableConfigKey(key)) {
             throw new DinoxError(`Unknown config key: ${key}`);
         }
-        if (key && isFixedConfigKey(key)) {
-            const resolved = resolveConfig(await loadConfig());
-            printYaml(getByPath(resolved, key));
-            return;
-        }
         const value = await getConfigValue(key);
-        const redacted = key ? value : redactConfigForDisplay(value);
+        const redacted = key ? value : sanitizeConfigForDisplay(value);
         printYaml(redacted);
     });
     configCmd

package/dist/commands/notes/index.js

@@ -8,7 +8,7 @@ import { printYaml } from '../../utils/output.js';
 import { resolveAuthIdentity } from '../../auth/userInfo.js';
 import { connectPowerSync, waitForIdleDataFlow } from '../../powersync/runtime.js';
 import { syncNoteTokenIndex } from '../../powersync/tokenIndex.js';
-import { createNote, getNote, getNoteDetail, resolveZettelBoxIdsForCreate, searchNotes, softDeleteNote, validateTagsForCreate, } from './repo.js';
+import { createNote, getNote, getNoteDetail, resolveZettelBoxIdsForCreate, resolveZettelBoxIdsForSearch, searchNotes, softDeleteNote, validateTagsForCreate, } from './repo.js';
 import { parseCreatedAtRange } from './searchTime.js';
 function parseSyncTimeoutMs(value) {
     if (typeof value !== 'string') {
@@ -78,6 +78,8 @@ export function registerNoteCommands(program) {
         .option('--from <date>', 'created_at start (YYYY-MM-DD or ISO datetime)')
         .option('--to <date>', 'created_at end (YYYY-MM-DD or ISO datetime)')
         .option('--days <n>', 'recent N days by created_at (cannot be used with --from/--to)')
+        .option('--box <string|@file>', 'zettel box names (JSON array or comma/newline-separated)')
+        .option('--sql <expr>', 'SQL-like expression over id/content_md/summary/tags/zettel_boxes/created_at/type')
         .option('--include-deleted', 'include soft-deleted notes')
         .action(async (query, options, command) => {
         const globals = command.optsWithGlobals?.() ?? {};
@@ -94,11 +96,17 @@ export function registerNoteCommands(program) {
                 to: options.to,
                 days: options.days,
             });
+            const boxInput = typeof options.box === 'string' ? options.box : '';
+            const zettelBoxNames = boxInput ? await parseStringListInput(boxInput, '--box') : [];
+            const zettelBoxIds = await resolveZettelBoxIdsForSearch(db, zettelBoxNames);
+            const sqlExpression = typeof options.sql === 'string' ? options.sql.trim() : '';
             const rows = await searchNotes(db, keyword, {
                 includeDeleted: Boolean(options.includeDeleted),
                 tagsExpression: tagsExpression || undefined,
                 createdAtFrom,
                 createdAtTo,
+                zettelBoxIds,
+                sqlExpression: sqlExpression || undefined,
             });
             printYaml(rows);
         }

package/dist/commands/notes/repo.d.ts

@@ -18,6 +18,8 @@ type SearchNotesOptions = {
     tagsExpression?: string;
     createdAtFrom?: string;
     createdAtTo?: string;
+    zettelBoxIds?: string[];
+    sqlExpression?: string;
 };
 export type SearchedNote = {
     id: string;
@@ -66,5 +68,6 @@ export declare function createNote(db: AbstractPowerSyncDatabase, input: {
 }>;
 export declare function validateTagsForCreate(db: AbstractPowerSyncDatabase, requestedTags: string[]): Promise<string[]>;
 export declare function resolveZettelBoxIdsForCreate(db: AbstractPowerSyncDatabase, requestedNames: string[]): Promise<string[]>;
+export declare function resolveZettelBoxIdsForSearch(db: AbstractPowerSyncDatabase, requestedNames: string[]): Promise<string[]>;
 export declare function softDeleteNote(db: AbstractPowerSyncDatabase, id: string): Promise<void>;
 export {};

package/dist/commands/notes/repo.js

@@ -3,16 +3,23 @@ import { nowIsoUtc } from '../../utils/time.js';
 import { tokenizeWithJieba } from '../../utils/tokenize.js';
 import { listBoxes } from '../boxes/repo.js';
 import { listTags } from '../tags/repo.js';
+import { buildNoteSearchSqlFilter } from './searchSql.js';
 export async function searchNotes(db, query, options) {
     const normalizedQuery = query.trim();
     const tagFilter = buildTagFilter(options.tagsExpression, 'n');
     const createdAtFilter = buildCreatedAtFilter(options.createdAtFrom, options.createdAtTo, 'n');
+    const zettelBoxFilter = buildZettelBoxFilter(options.zettelBoxIds, 'n');
+    const sqlFilter = await buildNoteSearchSqlFilter({
+        expression: options.sqlExpression,
+        noteAlias: 'n',
+        resolveZettelBoxNames: (names) => resolveZettelBoxIdsForSearch(db, names),
+    });
     let rows = [];
     if (!options.includeDeleted) {
         const ftsMatch = buildFtsMatchQuery(normalizedQuery);
         if (ftsMatch) {
             try {
-                rows = await searchNotesWithFts(db, ftsMatch, tagFilter, createdAtFilter);
+                rows = await searchNotesWithFts(db, ftsMatch, tagFilter, createdAtFilter, zettelBoxFilter, sqlFilter);
                 return enrichSearchRows(db, rows);
             }
             catch (error) {
@@ -53,6 +60,14 @@ export async function searchNotes(db, query, options) {
         whereClauses.push(createdAtFilter.sql);
         params.push(...createdAtFilter.params);
     }
+    if (zettelBoxFilter) {
+        whereClauses.push(zettelBoxFilter.sql);
+        params.push(...zettelBoxFilter.params);
+    }
+    if (sqlFilter) {
+        whereClauses.push(sqlFilter.sql);
+        params.push(...sqlFilter.params);
+    }
     rows = await db.getAll(`
     SELECT
       n.id,
@@ -69,7 +84,7 @@ export async function searchNotes(db, query, options) {
     `, params);
     return enrichSearchRows(db, rows);
 }
-async function searchNotesWithFts(db, matchQuery, tagFilter, createdAtFilter) {
+async function searchNotesWithFts(db, matchQuery, tagFilter, createdAtFilter, zettelBoxFilter, sqlFilter) {
     const whereClauses = ['(n.is_del IS NULL OR n.is_del = 0)', 'note_local_fts MATCH ?'];
     const params = [matchQuery];
     if (tagFilter) {
@@ -80,6 +95,14 @@ async function searchNotesWithFts(db, matchQuery, tagFilter, createdAtFilter) {
         whereClauses.push(createdAtFilter.sql);
         params.push(...createdAtFilter.params);
     }
+    if (zettelBoxFilter) {
+        whereClauses.push(zettelBoxFilter.sql);
+        params.push(...zettelBoxFilter.params);
+    }
+    if (sqlFilter) {
+        whereClauses.push(sqlFilter.sql);
+        params.push(...sqlFilter.params);
+    }
     return db.getAll(`
     SELECT
       n.id,
@@ -214,6 +237,30 @@ function buildCreatedAtFilter(createdAtFrom, createdAtTo, noteAlias) {
         params,
     };
 }
+function buildZettelBoxFilter(zettelBoxIds, noteAlias) {
+    const normalizedIds = Array.from(new Set((zettelBoxIds ?? [])
+        .map((id) => id.trim())
+        .filter((id) => id.length > 0)));
+    if (normalizedIds.length === 0) {
+        return null;
+    }
+    const placeholders = normalizedIds.map(() => '?').join(', ');
+    return {
+        sql: `
+      EXISTS (
+        SELECT 1
+        FROM json_each(
+          CASE
+            WHEN json_valid(COALESCE(${noteAlias}.zettel_boxes, '')) THEN ${noteAlias}.zettel_boxes
+            ELSE '[]'
+          END
+        ) box_item
+        WHERE TRIM(CAST(box_item.value AS TEXT)) IN (${placeholders})
+      )
+    `,
+        params: normalizedIds,
+    };
+}
 function parseTagExpression(expression) {
     const tokens = tokenizeTagExpression(expression);
     if (tokens.length === 0) {
@@ -537,6 +584,13 @@ export async function createNote(db, input) {
 function normalizeLookupKey(value) {
     return value.trim().toLowerCase();
 }
+function buildZettelBoxRetryQuestion(intent, type) {
+    const command = intent === 'search' ? 'dino note search' : 'dino note create';
+    if (type === 'ambiguous') {
+        return `Do you want to specify unique box names (or IDs) and retry \`${command}\`?`;
+    }
+    return `Do you want to add these missing boxes and retry \`${command}\`?`;
+}
 export async function validateTagsForCreate(db, requestedTags) {
     if (requestedTags.length === 0) {
         return [];
@@ -580,6 +634,12 @@ export async function validateTagsForCreate(db, requestedTags) {
     return resolved;
 }
 export async function resolveZettelBoxIdsForCreate(db, requestedNames) {
+    return resolveZettelBoxIdsByName(db, requestedNames, 'create');
+}
+export async function resolveZettelBoxIdsForSearch(db, requestedNames) {
+    return resolveZettelBoxIdsByName(db, requestedNames, 'search');
+}
+async function resolveZettelBoxIdsByName(db, requestedNames, intent) {
     if (requestedNames.length === 0) {
         return [];
     }
@@ -642,7 +702,7 @@ export async function resolveZettelBoxIdsForCreate(db, requestedNames) {
                 type: 'ambiguous_zettel_boxes',
                 ambiguous,
                 availableNamesSample: availableNames.slice(0, 20),
-                question: 'Do you want to specify unique box names (or IDs) and retry `dino note create`?',
+                question: buildZettelBoxRetryQuestion(intent, 'ambiguous'),
             },
         });
     }
@@ -653,7 +713,7 @@ export async function resolveZettelBoxIdsForCreate(db, requestedNames) {
                 missing,
                 availableCount: availableNames.length,
                 availableNamesSample: availableNames.slice(0, 20),
-                question: 'Do you want to add these missing boxes and retry `dino note create`?',
+                question: buildZettelBoxRetryQuestion(intent, 'missing'),
             },
         });
     }

package/dist/commands/notes/searchSql.d.ts

@@ -0,0 +1,11 @@
+export type SqlFilter = {
+    sql: string;
+    params: string[];
+};
+type BuildNoteSearchSqlFilterOptions = {
+    expression?: string;
+    noteAlias: string;
+    resolveZettelBoxNames: (names: string[]) => Promise<string[]>;
+};
+export declare function buildNoteSearchSqlFilter(options: BuildNoteSearchSqlFilterOptions): Promise<SqlFilter | null>;
+export {};