@framers/agentos 0.1.101 → 0.1.102

package/dist/memory/io/MarkdownImporter.js

@@ -0,0 +1,166 @@
+/**
+ * @fileoverview Markdown importer for AgentOS memory brain.
+ *
+ * Recursively walks a directory of Markdown files and inserts each file as a
+ * memory trace in the target `SqliteBrain`.  Front-matter fields (parsed via
+ * `gray-matter`) are mapped to trace columns; the document body becomes the
+ * trace content.
+ *
+ * Deduplication uses SHA-256 of the content body — files already present in
+ * the target brain (same hash in `metadata.import_hash`) are skipped.
+ *
+ * @module memory/io/MarkdownImporter
+ */
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import crypto from 'node:crypto';
+import { v4 as uuidv4 } from 'uuid';
+import matter from 'gray-matter';
+// ---------------------------------------------------------------------------
+// MarkdownImporter
+// ---------------------------------------------------------------------------
+/**
+ * Imports Markdown files from a directory into a `SqliteBrain`.
+ *
+ * **Usage:**
+ * ```ts
+ * const importer = new MarkdownImporter(brain);
+ * const result = await importer.import('/path/to/vault');
+ * console.log(result.imported, result.skipped);
+ * ```
+ */
+export class MarkdownImporter {
+    /**
+     * @param brain - The target `SqliteBrain` to import into.
+     */
+    constructor(brain) {
+        this.brain = brain;
+    }
+    // -------------------------------------------------------------------------
+    // Public API
+    // -------------------------------------------------------------------------
+    /**
+     * Recursively walk `sourceDir`, parse every `.md` file, and insert traces.
+     *
+     * Non-Markdown files are silently ignored.  Files that fail to parse are
+     * recorded in `result.errors` and processing continues.
+     *
+     * @param sourceDir - Directory to recursively scan for `.md` files.
+     * @returns `ImportResult` with counts of imported, skipped, and errored items.
+     */
+    async import(sourceDir) {
+        const result = { imported: 0, skipped: 0, errors: [] };
+        const files = await this._collectMarkdownFiles(sourceDir);
+        for (const filePath of files) {
+            await this._processFile(filePath, result);
+        }
+        return result;
+    }
+    // -------------------------------------------------------------------------
+    // Protected helpers (overridden by ObsidianImporter)
+    // -------------------------------------------------------------------------
+    /**
+     * Post-process a parsed file before it is inserted into the database.
+     *
+     * The base implementation is a no-op.  `ObsidianImporter` overrides this
+     * to extract `[[wikilinks]]` and `#tags`.
+     *
+     * @param _filePath   - Absolute path of the source file.
+     * @param _frontmatter - Parsed front-matter data.
+     * @param _body       - Markdown body content.
+     * @param _result     - Mutable result accumulator.
+     * @param _traceId    - The ID assigned (or taken from front-matter) for this trace.
+     */
+    async postProcess(_filePath, _frontmatter, _body, _result, _traceId) {
+        // No-op in base class.
+    }
+    // -------------------------------------------------------------------------
+    // Private helpers
+    // -------------------------------------------------------------------------
+    /**
+     * Recursively collect all `.md` file paths under `dir`.
+     *
+     * @param dir - Root directory to scan.
+     * @returns Sorted list of absolute file paths.
+     */
+    async _collectMarkdownFiles(dir) {
+        const results = [];
+        async function walk(current) {
+            let entries;
+            try {
+                entries = await fs.readdir(current, { withFileTypes: true });
+            }
+            catch {
+                return; // Directory not readable — skip.
+            }
+            for (const entry of entries) {
+                const full = path.join(current, entry.name);
+                if (entry.isDirectory()) {
+                    await walk(full);
+                }
+                else if (entry.isFile() && entry.name.endsWith('.md')) {
+                    results.push(full);
+                }
+            }
+        }
+        await walk(dir);
+        return results.sort();
+    }
+    /**
+     * Parse and insert a single Markdown file.
+     *
+     * @param filePath - Absolute path to the `.md` file.
+     * @param result   - Mutable `ImportResult` accumulator.
+     */
+    async _processFile(filePath, result) {
+        let raw;
+        try {
+            raw = await fs.readFile(filePath, 'utf8');
+        }
+        catch (err) {
+            result.errors.push(`Cannot read ${filePath}: ${String(err)}`);
+            return;
+        }
+        let parsed;
+        try {
+            parsed = matter(raw);
+        }
+        catch (err) {
+            result.errors.push(`Cannot parse front-matter in ${filePath}: ${String(err)}`);
+            return;
+        }
+        const fm = parsed.data;
+        const body = parsed.content.trim();
+        if (!body) {
+            result.skipped++;
+            return;
+        }
+        const hash = crypto.createHash('sha256').update(body, 'utf8').digest('hex');
+        // Dedup check.
+        const existing = this.brain.db
+            .prepare(`SELECT id FROM memory_traces WHERE json_extract(metadata, '$.import_hash') = ? LIMIT 1`)
+            .get(hash);
+        if (existing) {
+            result.skipped++;
+            return;
+        }
+        const traceId = (typeof fm.id === 'string' && fm.id) ? fm.id : `mt_${uuidv4()}`;
+        const tags = Array.isArray(fm.tags) ? fm.tags : [];
+        const meta = { import_hash: hash, source_file: filePath };
+        try {
+            this.brain.db
+                .prepare(`INSERT INTO memory_traces
+             (id, type, scope, content, embedding, strength, created_at, last_accessed,
+              retrieval_count, tags, emotions, metadata, deleted)
+           VALUES (?, ?, ?, ?, NULL, ?, ?, NULL, 0, ?, '{}', ?, 0)`)
+                .run(traceId, typeof fm.type === 'string' ? fm.type : 'episodic', typeof fm.scope === 'string' ? fm.scope : 'user', body, typeof fm.strength === 'number' ? fm.strength : 1.0, typeof fm.createdAt === 'number' ? fm.createdAt : Date.now(), JSON.stringify(tags), JSON.stringify(meta));
+            // Give subclasses a chance to handle wikilinks, extra tags, etc.
+            await this.postProcess(filePath, fm, body, result, traceId);
+            result.imported++;
+        }
+        catch (err) {
+            result.errors.push(`Insert error for ${filePath}: ${String(err)}`);
+        }
+    }
+}
+//# sourceMappingURL=MarkdownImporter.js.map

package/dist/memory/io/MarkdownImporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MarkdownImporter.js","sourceRoot":"","sources":["../../../src/memory/io/MarkdownImporter.ts"],"names":[],"mappings":"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"}

package/dist/memory/io/ObsidianExporter.d.ts

@@ -0,0 +1,80 @@
+/**
+ * @fileoverview Obsidian vault exporter for AgentOS memory brain.
+ *
+ * Extends `MarkdownExporter` with Obsidian-specific enrichments:
+ *
+ * 1. **`#tag` decorations** — each trace tag is appended to the document body
+ *    as an Obsidian-recognisable inline hashtag.
+ *
+ * 2. **`[[wikilinks]]`** — for each trace, the exporter queries
+ *    `knowledge_edges` for related entities that share the same trace ID as
+ *    a source.  Related knowledge-node labels are appended as `[[label]]`
+ *    links so Obsidian's graph view can visualise the semantic network.
+ *
+ * The folder layout mirrors `MarkdownExporter`:
+ * ```
+ * {outputDir}/
+ *   user/
+ *     episodic/
+ *       mt_abc123.md    ← includes [[related-node]] + #tag at bottom
+ * ```
+ *
+ * @module memory/io/ObsidianExporter
+ */
+import type { ExportOptions } from '../facade/types.js';
+import { MarkdownExporter } from './MarkdownExporter.js';
+/** Raw row shape from the `memory_traces` table (subset used here). */
+interface TraceRow {
+    id: string;
+    type: string;
+    scope: string;
+    content: string;
+    strength: number;
+    created_at: number;
+    tags: string;
+}
+/**
+ * Exports memory traces as an Obsidian-compatible Markdown vault.
+ *
+ * **Usage:**
+ * ```ts
+ * const exporter = new ObsidianExporter(brain);
+ * await exporter.export('/path/to/obsidian-vault');
+ * ```
+ */
+export declare class ObsidianExporter extends MarkdownExporter {
+    /**
+     * Export all memory traces as Obsidian-flavoured `.md` files.
+     *
+     * Delegates to the parent `export()` method — directory creation and file
+     * writing are handled there; only `buildFileContent` is overridden.
+     *
+     * @param outputDir - Root directory to write the Obsidian vault into.
+     * @param options   - Optional export configuration.
+     */
+    export(outputDir: string, options?: ExportOptions): Promise<void>;
+    /**
+     * Build Obsidian-flavoured Markdown for a trace.
+     *
+     * Additions over the base implementation:
+     * - Tags are rendered as `#tagName` inline hashtags in the body.
+     * - Related knowledge nodes (found via `knowledge_edges`) are rendered as
+     *   `[[Node Label]]` wikilinks appended at the bottom of the note.
+     *
+     * @param trace - Parsed trace row.
+     * @returns Full Markdown file content with front-matter.
+     */
+    protected buildFileContent(trace: TraceRow): string;
+    /**
+     * Query `knowledge_edges` for nodes related to the given trace ID.
+     *
+     * Only edges whose `source_id` matches the trace ID are considered.
+     * The target node's `label` is returned for wikilink generation.
+     *
+     * @param traceId - The memory trace ID to look up edges for.
+     * @returns Array of knowledge node labels linked to this trace.
+     */
+    private _fetchRelatedNodes;
+}
+export {};
+//# sourceMappingURL=ObsidianExporter.d.ts.map

package/dist/memory/io/ObsidianExporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObsidianExporter.d.ts","sourceRoot":"","sources":["../../../src/memory/io/ObsidianExporter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAMzD,uEAAuE;AACvE,UAAU,QAAQ;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAWD;;;;;;;;GAQG;AACH,qBAAa,gBAAiB,SAAQ,gBAAgB;IAKpD;;;;;;;;OAQG;IACY,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAQhF;;;;;;;;;;OAUG;cACgB,gBAAgB,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM;IAyC5D;;;;;;;;OAQG;IACH,OAAO,CAAC,kBAAkB;CAkB3B"}

package/dist/memory/io/ObsidianExporter.js

@@ -0,0 +1,127 @@
+/**
+ * @fileoverview Obsidian vault exporter for AgentOS memory brain.
+ *
+ * Extends `MarkdownExporter` with Obsidian-specific enrichments:
+ *
+ * 1. **`#tag` decorations** — each trace tag is appended to the document body
+ *    as an Obsidian-recognisable inline hashtag.
+ *
+ * 2. **`[[wikilinks]]`** — for each trace, the exporter queries
+ *    `knowledge_edges` for related entities that share the same trace ID as
+ *    a source.  Related knowledge-node labels are appended as `[[label]]`
+ *    links so Obsidian's graph view can visualise the semantic network.
+ *
+ * The folder layout mirrors `MarkdownExporter`:
+ * ```
+ * {outputDir}/
+ *   user/
+ *     episodic/
+ *       mt_abc123.md    ← includes [[related-node]] + #tag at bottom
+ * ```
+ *
+ * @module memory/io/ObsidianExporter
+ */
+import matter from 'gray-matter';
+import { MarkdownExporter } from './MarkdownExporter.js';
+// ---------------------------------------------------------------------------
+// ObsidianExporter
+// ---------------------------------------------------------------------------
+/**
+ * Exports memory traces as an Obsidian-compatible Markdown vault.
+ *
+ * **Usage:**
+ * ```ts
+ * const exporter = new ObsidianExporter(brain);
+ * await exporter.export('/path/to/obsidian-vault');
+ * ```
+ */
+export class ObsidianExporter extends MarkdownExporter {
+    // -------------------------------------------------------------------------
+    // Public API
+    // -------------------------------------------------------------------------
+    /**
+     * Export all memory traces as Obsidian-flavoured `.md` files.
+     *
+     * Delegates to the parent `export()` method — directory creation and file
+     * writing are handled there; only `buildFileContent` is overridden.
+     *
+     * @param outputDir - Root directory to write the Obsidian vault into.
+     * @param options   - Optional export configuration.
+     */
+    async export(outputDir, options) {
+        await super.export(outputDir, options);
+    }
+    // -------------------------------------------------------------------------
+    // Overridden helpers
+    // -------------------------------------------------------------------------
+    /**
+     * Build Obsidian-flavoured Markdown for a trace.
+     *
+     * Additions over the base implementation:
+     * - Tags are rendered as `#tagName` inline hashtags in the body.
+     * - Related knowledge nodes (found via `knowledge_edges`) are rendered as
+     *   `[[Node Label]]` wikilinks appended at the bottom of the note.
+     *
+     * @param trace - Parsed trace row.
+     * @returns Full Markdown file content with front-matter.
+     */
+    buildFileContent(trace) {
+        let tags = [];
+        try {
+            tags = JSON.parse(trace.tags);
+        }
+        catch {
+            tags = [];
+        }
+        // Render inline #hashtags so Obsidian picks them up in tag search.
+        const tagLine = tags.length > 0
+            ? '\n\n' + tags.map((t) => `#${t.replace(/\s+/g, '-')}`).join(' ')
+            : '';
+        // Fetch related knowledge nodes via edges where source === trace ID.
+        // We query knowledge_edges by source_id and join knowledge_nodes to get
+        // the human-readable label for the wikilink.
+        const relatedNodes = this._fetchRelatedNodes(trace.id);
+        const wikiLinks = relatedNodes.length > 0
+            ? '\n\n**Related:**\n' +
+                relatedNodes.map((label) => `- [[${label}]]`).join('\n')
+            : '';
+        const body = trace.content + tagLine + wikiLinks;
+        return matter.stringify(body, {
+            id: trace.id,
+            type: trace.type,
+            scope: trace.scope,
+            strength: trace.strength,
+            tags,
+            createdAt: trace.created_at,
+        });
+    }
+    // -------------------------------------------------------------------------
+    // Private helpers
+    // -------------------------------------------------------------------------
+    /**
+     * Query `knowledge_edges` for nodes related to the given trace ID.
+     *
+     * Only edges whose `source_id` matches the trace ID are considered.
+     * The target node's `label` is returned for wikilink generation.
+     *
+     * @param traceId - The memory trace ID to look up edges for.
+     * @returns Array of knowledge node labels linked to this trace.
+     */
+    _fetchRelatedNodes(traceId) {
+        try {
+            const rows = this.brain.db
+                .prepare(`SELECT kn.label
+           FROM knowledge_edges ke
+           JOIN knowledge_nodes kn ON kn.id = ke.target_id
+           WHERE ke.source_id = ?
+           LIMIT 50`)
+                .all(traceId);
+            return rows.map((r) => r.label);
+        }
+        catch {
+            // If the knowledge graph isn't populated, return empty gracefully.
+            return [];
+        }
+    }
+}
+//# sourceMappingURL=ObsidianExporter.js.map

package/dist/memory/io/ObsidianExporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObsidianExporter.js","sourceRoot":"","sources":["../../../src/memory/io/ObsidianExporter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,MAAM,MAAM,aAAa,CAAC;AAEjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAsBzD,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E;;;;;;;;GAQG;AACH,MAAM,OAAO,gBAAiB,SAAQ,gBAAgB;IACpD,4EAA4E;IAC5E,aAAa;IACb,4EAA4E;IAE5E;;;;;;;;OAQG;IACM,KAAK,CAAC,MAAM,CAAC,SAAiB,EAAE,OAAuB;QAC9D,MAAM,KAAK,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;IAED,4EAA4E;IAC5E,qBAAqB;IACrB,4EAA4E;IAE5E;;;;;;;;;;OAUG;IACgB,gBAAgB,CAAC,KAAe;QACjD,IAAI,IAAI,GAAa,EAAE,CAAC;QACxB,IAAI,CAAC;YACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAa,CAAC;QAC5C,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,GAAG,EAAE,CAAC;QACZ,CAAC;QAED,mEAAmE;QACnE,MAAM,OAAO,GACX,IAAI,CAAC,MAAM,GAAG,CAAC;YACb,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;YAClE,CAAC,CAAC,EAAE,CAAC;QAET,qEAAqE;QACrE,wEAAwE;QACxE,6CAA6C;QAC7C,MAAM,YAAY,GAAG,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAEvD,MAAM,SAAS,GACb,YAAY,CAAC,MAAM,GAAG,CAAC;YACrB,CAAC,CAAC,oBAAoB;gBACpB,YAAY,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YAC1D,CAAC,CAAC,EAAE,CAAC;QAET,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,GAAG,OAAO,GAAG,SAAS,CAAC;QAEjD,OAAO,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE;YAC5B,EAAE,EAAE,KAAK,CAAC,EAAE;YACZ,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,IAAI;YACJ,SAAS,EAAE,KAAK,CAAC,UAAU;SAC5B,CAAC,CAAC;IACL,CAAC;IAED,4EAA4E;IAC5E,kBAAkB;IAClB,4EAA4E;IAE5E;;;;;;;;OAQG;IACK,kBAAkB,CAAC,OAAe;QACxC,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE;iBACvB,OAAO,CACN;;;;oBAIU,CACX;iBACA,GAAG,CAAC,OAAO,CAAC,CAAC;YAEhB,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAClC,CAAC;QAAC,MAAM,CAAC;YACP,mEAAmE;YACnE,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;CACF"}

package/dist/memory/io/ObsidianImporter.d.ts

@@ -0,0 +1,93 @@
+/**
+ * @fileoverview Obsidian vault importer for AgentOS memory brain.
+ *
+ * Extends `MarkdownImporter` with Obsidian-specific parsing:
+ *
+ * 1. **`[[wikilinks]]`** — each `[[Target Note]]` (or `[[Target|Alias]]`) in
+ *    a note's body is parsed.  For each wikilink, the importer looks up (or
+ *    creates) a `knowledge_nodes` entry for the target label and then creates
+ *    a `knowledge_edges` row of type `'related_to'` linking the source trace
+ *    node to the target node.
+ *
+ * 2. **`#tags`** — inline hashtags are extracted from the body and merged
+ *    into the trace's `tags` JSON column (in addition to any front-matter tags).
+ *
+ * 3. **`![[image.png]]`** — embedded-image syntax is detected and a warning
+ *    is logged.  Embedded images are not imported in the current version.
+ *
+ * @module memory/io/ObsidianImporter
+ */
+import type { ImportResult } from '../facade/types.js';
+import type { SqliteBrain } from '../store/SqliteBrain.js';
+import { MarkdownImporter } from './MarkdownImporter.js';
+/**
+ * Parsed front-matter fields (same shape as MarkdownImporter expects).
+ */
+interface TraceFrontmatter {
+    id?: string;
+    type?: string;
+    scope?: string;
+    strength?: number;
+    tags?: string[];
+    createdAt?: number;
+    [key: string]: unknown;
+}
+/**
+ * Imports an Obsidian vault (directory of Markdown files) into a `SqliteBrain`.
+ *
+ * **Usage:**
+ * ```ts
+ * const importer = new ObsidianImporter(brain);
+ * const result = await importer.import('/path/to/obsidian-vault');
+ * ```
+ */
+export declare class ObsidianImporter extends MarkdownImporter {
+    /**
+     * @param brain - The target `SqliteBrain` to import into.
+     */
+    constructor(brain: SqliteBrain);
+    /**
+     * Post-process a successfully imported Markdown file:
+     *
+     * 1. Warn about any embedded images (`![[...]]`).
+     * 2. Extract inline `#hashtags` and merge them into the trace's tag list.
+     * 3. Parse `[[wikilinks]]` and create `knowledge_edges` entries.
+     *
+     * @param _filePath    - Absolute path of the source file (unused here).
+     * @param _frontmatter - Parsed front-matter data.
+     * @param body         - Markdown body (content after front-matter).
+     * @param result       - Mutable `ImportResult` accumulator.
+     * @param traceId      - The ID of the just-inserted trace.
+     */
+    protected postProcess(_filePath: string, _frontmatter: TraceFrontmatter, body: string, result: ImportResult, traceId: string): Promise<void>;
+    /**
+     * Merge a list of inline hashtag names into a trace's `tags` JSON column.
+     *
+     * Reads the current tags array, deduplicates, and writes back.
+     *
+     * @param traceId    - ID of the trace to update.
+     * @param newTags    - Hashtag names to add (without the leading `#`).
+     * @param result     - Mutable result accumulator (errors recorded here).
+     */
+    private _mergeTagsIntoTrace;
+    /**
+     * Ensure `knowledge_nodes` entries exist for both the source trace and the
+     * target label, then create a `knowledge_edges` row (type `'related_to'`)
+     * linking them.
+     *
+     * Because `knowledge_edges.source_id` has a FK reference to
+     * `knowledge_nodes(id)`, we first upsert a node for the source trace (using
+     * the trace content as the label) before creating the edge.  This lets
+     * Obsidian's graph view visualise which note links to which concept.
+     *
+     * Both node upserts and the edge insert use `INSERT OR IGNORE` so repeated
+     * imports don't create duplicates.
+     *
+     * @param sourceTraceId - The memory trace ID that contains the wikilink.
+     * @param targetLabel   - The label of the linked note (wikilink target).
+     * @param result        - Mutable result accumulator.
+     */
+    private _upsertWikiEdge;
+}
+export {};
+//# sourceMappingURL=ObsidianImporter.d.ts.map

package/dist/memory/io/ObsidianImporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObsidianImporter.d.ts","sourceRoot":"","sources":["../../../src/memory/io/ObsidianImporter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AA6BzD;;GAEG;AACH,UAAU,gBAAgB;IACxB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAMD;;;;;;;;GAQG;AACH,qBAAa,gBAAiB,SAAQ,gBAAgB;IACpD;;OAEG;gBACS,KAAK,EAAE,WAAW;IAQ9B;;;;;;;;;;;;OAYG;cACsB,WAAW,CAClC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,gBAAgB,EAC9B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC;IAuChB;;;;;;;;OAQG;IACH,OAAO,CAAC,mBAAmB;IAgC3B;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CAAC,eAAe;CAsGxB"}