memkin 0.4.0

package/dist/collectors/feishu/docs/store-writer.js

@@ -0,0 +1,71 @@
+import { createHash } from "node:crypto";
+import { stringify as stringifyYaml } from "yaml";
+import { renderDocCardMarkdown } from "./render.js";
+export const docSlug = (docToken) => `feishu-docs/${docToken}`;
+/** First 8 hex chars of sha256(text) — stable per action-item text, not positional. */
+function actionItemHash(text) {
+    return createHash("sha256").update(text).digest("hex").slice(0, 8);
+}
+/** tasks/doc-<doc_token>-<hash8(text)> (Spec 9 §3.3). */
+export function actionItemTaskSlug(docToken, text) {
+    return `tasks/doc-${docToken}-${actionItemHash(text)}`;
+}
+function renderTaskMarkdown(docToken, item, ownerSlug) {
+    const fm = {
+        title: item.text,
+        type: "task",
+        status: item.status,
+        source: `doc:${docToken}`,
+    };
+    if (ownerSlug)
+        fm.owner_slug = ownerSlug;
+    if (item.due)
+        fm.due = item.due;
+    const yaml = stringifyYaml(fm).trimEnd();
+    return `---\n${yaml}\n---\n\n${item.text}\n`;
+}
+async function writeActionItems(stores, card, deps) {
+    if (card.extract_level !== "full")
+        return;
+    for (const item of card.action_items) {
+        const ownerSlug = item.owner_raw ? await deps.resolveOwner(item.owner_raw) : null;
+        const slug = actionItemTaskSlug(card.doc_token, item.text);
+        const content = renderTaskMarkdown(card.doc_token, item, ownerSlug);
+        const page = await stores.pages.putPage(slug, content, { halflife_days: null });
+        if (page.compiled_truth?.trim()) {
+            await stores.chunks.rechunk(page.id, page.compiled_truth);
+        }
+        if (ownerSlug) {
+            await deps.graph.addLink(slug, ownerSlug, "mentions");
+            if (ownerSlug !== "entities/me" && (await deps.isMe(ownerSlug))) {
+                await deps.graph.addLink(slug, "entities/me", "mentions");
+            }
+        }
+    }
+}
+export async function writeCard(stores, card, actionItemDeps) {
+    const content = renderDocCardMarkdown(card);
+    const page = await stores.pages.putPage(docSlug(card.doc_token), content, {
+        halflife_days: null,
+    });
+    await stores.chunks.rechunk(page.id, page.compiled_truth);
+    // Spec 9 §3.3: persist each action_item as a task signal anchored to its owner.
+    if (actionItemDeps && card.extract_level === "full" && card.action_items.length > 0) {
+        await writeActionItems(stores, card, actionItemDeps);
+    }
+}
+/**
+ * Reconstruct a stored card from its page frontmatter. The decision engine only
+ * needs extract_level, modified_at, and (for full cards) source_body_hash, but
+ * we cast the whole frontmatter — it was serialized from a DocCard by writeCard.
+ */
+export async function loadExistingCard(stores, docToken) {
+    const page = await stores.pages.getPage(docSlug(docToken));
+    if (!page)
+        return null;
+    const fm = page.frontmatter;
+    if (fm.extract_level !== "full" && fm.extract_level !== "pointer")
+        return null;
+    return fm;
+}
+//# sourceMappingURL=store-writer.js.map

package/dist/collectors/feishu/docs/store-writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-writer.js","sourceRoot":"","sources":["../../../../src/collectors/feishu/docs/store-writer.ts"],"names":[],"mappings":"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"}

package/dist/collectors/feishu/docs/toc.d.ts

@@ -0,0 +1,3 @@
+import type { DocBlock, TocItem } from "./types.js";
+export declare function extractTocFromBlocks(blocks: DocBlock[]): TocItem[];
+//# sourceMappingURL=toc.d.ts.map

package/dist/collectors/feishu/docs/toc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toc.d.ts","sourceRoot":"","sources":["../../../../src/collectors/feishu/docs/toc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAQpD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,EAAE,CAUlE"}

package/dist/collectors/feishu/docs/toc.js

@@ -0,0 +1,19 @@
+const HEADING_LEVEL = {
+    heading1: 1,
+    heading2: 2,
+    heading3: 3,
+};
+export function extractTocFromBlocks(blocks) {
+    const toc = [];
+    for (const block of blocks) {
+        const level = HEADING_LEVEL[block.type];
+        if (!level)
+            continue;
+        const title = block.text.trim();
+        if (!title)
+            continue;
+        toc.push({ level, title });
+    }
+    return toc;
+}
+//# sourceMappingURL=toc.js.map

package/dist/collectors/feishu/docs/toc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toc.js","sourceRoot":"","sources":["../../../../src/collectors/feishu/docs/toc.ts"],"names":[],"mappings":"AAEA,MAAM,aAAa,GAA8B;IAC/C,QAAQ,EAAE,CAAC;IACX,QAAQ,EAAE,CAAC;IACX,QAAQ,EAAE,CAAC;CACZ,CAAC;AAEF,MAAM,UAAU,oBAAoB,CAAC,MAAkB;IACrD,MAAM,GAAG,GAAc,EAAE,CAAC;IAC1B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC,KAAK;YAAE,SAAS;QACrB,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAChC,IAAI,CAAC,KAAK;YAAE,SAAS;QACrB,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/collectors/feishu/docs/triggers.d.ts

@@ -0,0 +1,7 @@
+import type { DocCandidate, DocDecisionConfig } from "./types.js";
+/**
+ * Returns the id of the first trigger that fires (T1, T2, T4 order), or null.
+ * `nowMs` is injected so the function stays pure/testable.
+ */
+export declare function evaluateTriggers(candidate: DocCandidate, config: DocDecisionConfig, selfOpenId: string, nowMs: number): string | null;
+//# sourceMappingURL=triggers.d.ts.map

package/dist/collectors/feishu/docs/triggers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"triggers.d.ts","sourceRoot":"","sources":["../../../../src/collectors/feishu/docs/triggers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAElE;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,YAAY,EACvB,MAAM,EAAE,iBAAiB,EACzB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,GACZ,MAAM,GAAG,IAAI,CA4Bf"}

package/dist/collectors/feishu/docs/triggers.js

@@ -0,0 +1,31 @@
+/**
+ * Returns the id of the first trigger that fires (T1, T2, T4 order), or null.
+ * `nowMs` is injected so the function stays pure/testable.
+ */
+export function evaluateTriggers(candidate, config, selfOpenId, nowMs) {
+    // T1 — self edit
+    if (config.self_edit && selfOpenId && candidate.last_editor_id === selfOpenId) {
+        return "T1";
+    }
+    // T2 — recency (off when recent_window_days is null)
+    if (config.recent_window_days != null) {
+        const modifiedMs = Date.parse(candidate.modified_at);
+        const windowMs = config.recent_window_days * 86_400_000;
+        if (!Number.isNaN(modifiedMs) && nowMs - modifiedMs <= windowMs) {
+            return "T2";
+        }
+    }
+    // T4 — important folder / wiki space
+    const src = candidate.source;
+    if (src.kind === "folder" && config.important_folders.includes(src.folder_token)) {
+        return "T4";
+    }
+    if (src.kind === "my_space" && config.important_folders.includes(src.folder_token)) {
+        return "T4";
+    }
+    if (src.kind === "wiki" && config.important_wiki_spaces.includes(src.space_id)) {
+        return "T4";
+    }
+    return null;
+}
+//# sourceMappingURL=triggers.js.map

package/dist/collectors/feishu/docs/triggers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"triggers.js","sourceRoot":"","sources":["../../../../src/collectors/feishu/docs/triggers.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAC9B,SAAuB,EACvB,MAAyB,EACzB,UAAkB,EAClB,KAAa;IAEb,iBAAiB;IACjB,IAAI,MAAM,CAAC,SAAS,IAAI,UAAU,IAAI,SAAS,CAAC,cAAc,KAAK,UAAU,EAAE,CAAC;QAC9E,OAAO,IAAI,CAAC;IACd,CAAC;IAED,qDAAqD;IACrD,IAAI,MAAM,CAAC,kBAAkB,IAAI,IAAI,EAAE,CAAC;QACtC,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QACrD,MAAM,QAAQ,GAAG,MAAM,CAAC,kBAAkB,GAAG,UAAU,CAAC;QACxD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,KAAK,GAAG,UAAU,IAAI,QAAQ,EAAE,CAAC;YAChE,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,qCAAqC;IACrC,MAAM,GAAG,GAAG,SAAS,CAAC,MAAM,CAAC;IAC7B,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,iBAAiB,CAAC,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;QACjF,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,GAAG,CAAC,IAAI,KAAK,UAAU,IAAI,MAAM,CAAC,iBAAiB,CAAC,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;QACnF,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,IAAI,MAAM,CAAC,qBAAqB,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC/E,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/collectors/feishu/docs/types.d.ts

@@ -0,0 +1,109 @@
+export type DocSourceOrigin = {
+    kind: "my_space";
+    folder_token: string;
+} | {
+    kind: "wiki";
+    space_id: string;
+    space_name: string;
+    node_token: string;
+} | {
+    kind: "folder";
+    folder_token: string;
+    folder_name: string;
+} | {
+    kind: "mcp_ingest";
+};
+export interface DocCandidate {
+    doc_token: string;
+    doc_type: "docx";
+    title: string;
+    url: string;
+    owner_id: string;
+    last_editor_id: string;
+    created_at: string;
+    modified_at: string;
+    source: DocSourceOrigin;
+    parent_path: string;
+}
+export interface EntityMention {
+    name: string;
+    type_guess: "person" | "project" | "tool" | "concept" | "organization";
+}
+export interface TocItem {
+    level: 1 | 2 | 3;
+    title: string;
+}
+export interface DocDecision {
+    text: string;
+    made_by_raw?: string;
+}
+export interface ActionItem {
+    text: string;
+    owner_raw?: string;
+    owner_slug?: string;
+    due?: string;
+    status: "open" | "done";
+}
+export interface PointerCard extends DocCandidate {
+    extract_level: "pointer";
+    extracted_at: string;
+    extract_error?: string;
+    extract_skipped?: string;
+    user_note?: string;
+}
+export interface FullCard extends DocCandidate {
+    extract_level: "full";
+    purpose: string;
+    topics: string[];
+    entities: EntityMention[];
+    toc: TocItem[];
+    overview: string;
+    decisions: DocDecision[];
+    action_items: ActionItem[];
+    source_body_hash: string;
+    summary_generated_at: string;
+    summary_model: string;
+    extracted_at: string;
+    user_note?: string;
+    tags?: string[];
+}
+export type DocCard = PointerCard | FullCard;
+export interface DocBlock {
+    type: "heading1" | "heading2" | "heading3" | "text" | "other";
+    text: string;
+}
+export interface DocDecisionConfig {
+    self_edit: boolean;
+    recent_window_days: number | null;
+    important_folders: string[];
+    important_wiki_spaces: string[];
+}
+export type Decision = {
+    action: "skip_save";
+} | {
+    action: "save_pointer";
+    reason: string;
+} | {
+    action: "queue_for_upgrade";
+    trigger: string;
+} | {
+    action: "needs_body_check";
+};
+export type BodyCheckDecision = {
+    action: "metadata_refresh";
+} | {
+    action: "queue_for_upgrade";
+    trigger: "T5";
+};
+export type ParsedFeishuUrl = {
+    kind: "docx";
+    token: string;
+} | {
+    kind: "wiki_node";
+    node_token: string;
+} | {
+    kind: "reject";
+    code: "INVALID_URL" | "UNSUPPORTED_DOC_TYPE";
+    message: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/collectors/feishu/docs/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/collectors/feishu/docs/types.ts"],"names":[],"mappings":"AACA,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAC1E;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAC7D;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,CAAC;AAG3B,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,eAAe,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;CACrB;AAGD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,cAAc,CAAC;CACxE;AAED,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAGD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,WAAY,SAAQ,YAAY;IAC/C,aAAa,EAAE,SAAS,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,QAAS,SAAQ,YAAY;IAC5C,aAAa,EAAE,MAAM,CAAC;IAEtB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,GAAG,EAAE,OAAO,EAAE,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,WAAW,EAAE,CAAC;IACzB,YAAY,EAAE,UAAU,EAAE,CAAC;IAE3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,MAAM,OAAO,GAAG,WAAW,GAAG,QAAQ,CAAC;AAM7C,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,UAAU,GAAG,UAAU,GAAG,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC;IAC9D,IAAI,EAAE,MAAM,CAAC;CACd;AAGD,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,OAAO,CAAC;IACnB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,qBAAqB,EAAE,MAAM,EAAE,CAAC;CACjC;AAGD,MAAM,MAAM,QAAQ,GAChB;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,GACvB;IAAE,MAAM,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC1C;IAAE,MAAM,EAAE,mBAAmB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAChD;IAAE,MAAM,EAAE,kBAAkB,CAAA;CAAE,CAAC;AAEnC,MAAM,MAAM,iBAAiB,GACzB;IAAE,MAAM,EAAE,kBAAkB,CAAA;CAAE,GAC9B;IAAE,MAAM,EAAE,mBAAmB,CAAC;IAAC,OAAO,EAAE,IAAI,CAAA;CAAE,CAAC;AAGnD,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACzC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,aAAa,GAAG,sBAAsB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/dist/collectors/feishu/docs/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/collectors/feishu/docs/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/collectors/feishu/docs/types.ts"],"names":[],"mappings":""}

package/dist/collectors/feishu/docs/upgrade-queue.d.ts

@@ -0,0 +1,19 @@
+export interface UpgradeQueueConfig {
+    batch_size: number;
+    bootstrap_batch_size: number;
+    bootstrap_runs: number;
+    max_pending: number;
+}
+export declare class UpgradeQueue {
+    private readonly maxPending;
+    private items;
+    private set;
+    constructor(initial: string[], maxPending: number);
+    /** Returns true if enqueued, false if duplicate or cap reached (dropped). */
+    enqueue(docToken: string): boolean;
+    shift(k: number): string[];
+    pending(): string[];
+    size(): number;
+}
+export declare function batchSizeForRun(runCount: number, cfg: UpgradeQueueConfig): number;
+//# sourceMappingURL=upgrade-queue.d.ts.map

package/dist/collectors/feishu/docs/upgrade-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade-queue.d.ts","sourceRoot":"","sources":["../../../../src/collectors/feishu/docs/upgrade-queue.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,YAAY;IAMrB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAL7B,OAAO,CAAC,KAAK,CAAW;IACxB,OAAO,CAAC,GAAG,CAAc;gBAGvB,OAAO,EAAE,MAAM,EAAE,EACA,UAAU,EAAE,MAAM;IAMrC,6EAA6E;IAC7E,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAQlC,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE;IAM1B,OAAO,IAAI,MAAM,EAAE;IAInB,IAAI,IAAI,MAAM;CAGf;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,kBAAkB,GAAG,MAAM,CAEjF"}

package/dist/collectors/feishu/docs/upgrade-queue.js

@@ -0,0 +1,36 @@
+export class UpgradeQueue {
+    maxPending;
+    items;
+    set;
+    constructor(initial, maxPending) {
+        this.maxPending = maxPending;
+        this.items = [...initial];
+        this.set = new Set(initial);
+    }
+    /** Returns true if enqueued, false if duplicate or cap reached (dropped). */
+    enqueue(docToken) {
+        if (this.set.has(docToken))
+            return false;
+        if (this.items.length >= this.maxPending)
+            return false;
+        this.items.push(docToken);
+        this.set.add(docToken);
+        return true;
+    }
+    shift(k) {
+        const batch = this.items.splice(0, k);
+        for (const t of batch)
+            this.set.delete(t);
+        return batch;
+    }
+    pending() {
+        return [...this.items];
+    }
+    size() {
+        return this.items.length;
+    }
+}
+export function batchSizeForRun(runCount, cfg) {
+    return runCount < cfg.bootstrap_runs ? cfg.bootstrap_batch_size : cfg.batch_size;
+}
+//# sourceMappingURL=upgrade-queue.js.map

package/dist/collectors/feishu/docs/upgrade-queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade-queue.js","sourceRoot":"","sources":["../../../../src/collectors/feishu/docs/upgrade-queue.ts"],"names":[],"mappings":"AAOA,MAAM,OAAO,YAAY;IAMJ;IALX,KAAK,CAAW;IAChB,GAAG,CAAc;IAEzB,YACE,OAAiB,EACA,UAAkB;QAAlB,eAAU,GAAV,UAAU,CAAQ;QAEnC,IAAI,CAAC,KAAK,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC;QAC1B,IAAI,CAAC,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IAED,6EAA6E;IAC7E,OAAO,CAAC,QAAgB;QACtB,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC;YAAE,OAAO,KAAK,CAAC;QACzC,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC,UAAU;YAAE,OAAO,KAAK,CAAC;QACvD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC1B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,CAAS;QACb,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACtC,KAAK,MAAM,CAAC,IAAI,KAAK;YAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC1C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO;QACL,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;IAED,IAAI;QACF,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;IAC3B,CAAC;CACF;AAED,MAAM,UAAU,eAAe,CAAC,QAAgB,EAAE,GAAuB;IACvE,OAAO,QAAQ,GAAG,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC;AACnF,CAAC"}

package/dist/collectors/feishu/docs/url-parser.d.ts

@@ -0,0 +1,3 @@
+import type { ParsedFeishuUrl } from "./types.js";
+export declare function parseFeishuUrl(input: string): ParsedFeishuUrl;
+//# sourceMappingURL=url-parser.d.ts.map

package/dist/collectors/feishu/docs/url-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-parser.d.ts","sourceRoot":"","sources":["../../../../src/collectors/feishu/docs/url-parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAQlD,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,CAsC7D"}

package/dist/collectors/feishu/docs/url-parser.js

@@ -0,0 +1,39 @@
+const RAW_TOKEN = /^[A-Za-z0-9]{20,}$/;
+const DOCX_URL = /feishu\.[a-z]+\/docx\/([^/?#]+)/;
+const WIKI_URL = /feishu\.[a-z]+\/wiki\/([^/?#]+)/;
+const OLD_DOC_URL = /feishu\.[a-z]+\/docs\//;
+const UNSUPPORTED_URL = /feishu\.[a-z]+\/(sheets|base|mindnotes|file|slides)\//;
+export function parseFeishuUrl(input) {
+    const value = input.trim();
+    if (RAW_TOKEN.test(value)) {
+        return { kind: "docx", token: value };
+    }
+    const docx = value.match(DOCX_URL);
+    if (docx) {
+        return { kind: "docx", token: docx[1] };
+    }
+    const wiki = value.match(WIKI_URL);
+    if (wiki) {
+        return { kind: "wiki_node", node_token: wiki[1] };
+    }
+    if (OLD_DOC_URL.test(value)) {
+        return {
+            kind: "reject",
+            code: "UNSUPPORTED_DOC_TYPE",
+            message: "Old /docs/ documents are not supported in v1 (docx only)",
+        };
+    }
+    if (UNSUPPORTED_URL.test(value)) {
+        return {
+            kind: "reject",
+            code: "UNSUPPORTED_DOC_TYPE",
+            message: "Only docx is supported in v1",
+        };
+    }
+    return {
+        kind: "reject",
+        code: "INVALID_URL",
+        message: `Unrecognized Feishu URL or token: ${input}`,
+    };
+}
+//# sourceMappingURL=url-parser.js.map

package/dist/collectors/feishu/docs/url-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-parser.js","sourceRoot":"","sources":["../../../../src/collectors/feishu/docs/url-parser.ts"],"names":[],"mappings":"AAEA,MAAM,SAAS,GAAG,oBAAoB,CAAC;AACvC,MAAM,QAAQ,GAAG,iCAAiC,CAAC;AACnD,MAAM,QAAQ,GAAG,iCAAiC,CAAC;AACnD,MAAM,WAAW,GAAG,wBAAwB,CAAC;AAC7C,MAAM,eAAe,GAAG,uDAAuD,CAAC;AAEhF,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAE3B,IAAI,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IACxC,CAAC;IAED,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACnC,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1C,CAAC;IAED,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACnC,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IACpD,CAAC;IAED,IAAI,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,sBAAsB;YAC5B,OAAO,EAAE,0DAA0D;SACpE,CAAC;IACJ,CAAC;IAED,IAAI,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAChC,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,sBAAsB;YAC5B,OAAO,EAAE,8BAA8B;SACxC,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,aAAa;QACnB,OAAO,EAAE,qCAAqC,KAAK,EAAE;KACtD,CAAC;AACJ,CAAC"}

package/dist/collectors/feishu/docs/walkers.d.ts

@@ -0,0 +1,24 @@
+import type { IFeishuHttpClient } from "../http-client.js";
+import type { ResolvedDocsConfig } from "./config.js";
+import type { DocCandidate, DocSourceOrigin } from "./types.js";
+/**
+ * Recursively walk a drive folder. docx files → candidates; folders → recurse
+ * while depth budget remains. `source` describes the origin for emitted
+ * candidates; `parentPath` is the human-readable breadcrumb.
+ * CALIBRATED 2026-06-14: drive/v1/files rows carry `type` with live values
+ * folder/docx/bitable/file, so `file.type === "folder"` / `"docx"` are correct.
+ */
+export declare function walkDriveFolder(client: IFeishuHttpClient, folderToken: string, source: DocSourceOrigin, parentPath: string, maxDepth: number): AsyncGenerator<DocCandidate>;
+/**
+ * Walk every wiki space (minus excluded ids) and emit docx nodes.
+ * CALIBRATED 2026-06-14: wiki/v2/spaces rows expose `space_id`/`name`, and
+ * wiki/v2/spaces/<id>/nodes rows expose `node_token`/`obj_token`/`obj_type`/
+ * `title` plus `owner` (the last-editor field, NOT `owner_id`) and a real `url`.
+ */
+export declare function walkWiki(client: IFeishuHttpClient, excludeSpaceIds: string[]): AsyncGenerator<DocCandidate>;
+/**
+ * Union of all configured walkers, deduped by doc_token. My Space first, then
+ * whitelist folders, then Wiki — first occurrence wins.
+ */
+export declare function iterateCandidates(client: IFeishuHttpClient, config: ResolvedDocsConfig): AsyncGenerator<DocCandidate>;
+//# sourceMappingURL=walkers.d.ts.map

package/dist/collectors/feishu/docs/walkers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"walkers.d.ts","sourceRoot":"","sources":["../../../../src/collectors/feishu/docs/walkers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAG3D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEhE;;;;;;GAMG;AACH,wBAAuB,eAAe,CACpC,MAAM,EAAE,iBAAiB,EACzB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,eAAe,EACvB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,cAAc,CAAC,YAAY,CAAC,CAsB9B;AAOD;;;;;GAKG;AACH,wBAAuB,QAAQ,CAC7B,MAAM,EAAE,iBAAiB,EACzB,eAAe,EAAE,MAAM,EAAE,GACxB,cAAc,CAAC,YAAY,CAAC,CAwB9B;AAeD;;;GAGG;AACH,wBAAuB,iBAAiB,CACtC,MAAM,EAAE,iBAAiB,EACzB,MAAM,EAAE,kBAAkB,GACzB,cAAc,CAAC,YAAY,CAAC,CAyC9B"}

package/dist/collectors/feishu/docs/walkers.js

@@ -0,0 +1,90 @@
+import { driveFileToCandidate, wikiNodeToCandidate } from "./candidate.js";
+/**
+ * Recursively walk a drive folder. docx files → candidates; folders → recurse
+ * while depth budget remains. `source` describes the origin for emitted
+ * candidates; `parentPath` is the human-readable breadcrumb.
+ * CALIBRATED 2026-06-14: drive/v1/files rows carry `type` with live values
+ * folder/docx/bitable/file, so `file.type === "folder"` / `"docx"` are correct.
+ */
+export async function* walkDriveFolder(client, folderToken, source, parentPath, maxDepth) {
+    for await (const page of client.paginate("/open-apis/drive/v1/files", {
+        folder_token: folderToken,
+        page_size: "50",
+    })) {
+        for (const file of page.items) {
+            if (file.type === "folder") {
+                if (maxDepth > 0) {
+                    yield* walkDriveFolder(client, file.token, source, `${parentPath}${file.name}/`, maxDepth - 1);
+                }
+                continue;
+            }
+            if (file.type !== "docx")
+                continue;
+            yield driveFileToCandidate(file, source, parentPath);
+        }
+    }
+}
+/**
+ * Walk every wiki space (minus excluded ids) and emit docx nodes.
+ * CALIBRATED 2026-06-14: wiki/v2/spaces rows expose `space_id`/`name`, and
+ * wiki/v2/spaces/<id>/nodes rows expose `node_token`/`obj_token`/`obj_type`/
+ * `title` plus `owner` (the last-editor field, NOT `owner_id`) and a real `url`.
+ */
+export async function* walkWiki(client, excludeSpaceIds) {
+    const excluded = new Set(excludeSpaceIds);
+    for await (const spacePage of client.paginate("/open-apis/wiki/v2/spaces")) {
+        for (const space of spacePage.items) {
+            if (excluded.has(space.space_id))
+                continue;
+            for await (const nodePage of client.paginate(`/open-apis/wiki/v2/spaces/${space.space_id}/nodes`)) {
+                for (const node of nodePage.items) {
+                    if (node.obj_type !== "docx")
+                        continue;
+                    yield wikiNodeToCandidate(node, {
+                        kind: "wiki",
+                        space_id: space.space_id,
+                        space_name: space.name,
+                        node_token: node.node_token,
+                    }, `Wiki/${space.name}/`);
+                }
+            }
+        }
+    }
+}
+/**
+ * CALIBRATED 2026-06-14 against real lark-cli: the endpoint is the explorer v2
+ * API (the drive/v1 path returns HTTP 404), and the root token is at data.token.
+ * Real response: { code: 0, data: { id, token, user_id }, msg: "success" }.
+ */
+async function getMySpaceRoot(client) {
+    const res = await client.request("GET", "/open-apis/drive/explorer/v2/root_folder/meta");
+    return res.data?.token ?? null;
+}
+/**
+ * Union of all configured walkers, deduped by doc_token. My Space first, then
+ * whitelist folders, then Wiki — first occurrence wins.
+ */
+export async function* iterateCandidates(client, config) {
+    const seen = new Set();
+    const emit = async function* (gen) {
+        for await (const c of gen) {
+            if (seen.has(c.doc_token))
+                continue;
+            seen.add(c.doc_token);
+            yield c;
+        }
+    };
+    if (config.my_space.enabled) {
+        const root = await getMySpaceRoot(client);
+        if (root) {
+            yield* emit(walkDriveFolder(client, root, { kind: "my_space", folder_token: root }, "My Space/", config.my_space.max_depth));
+        }
+    }
+    for (const folder of config.folders) {
+        yield* emit(walkDriveFolder(client, folder.token, { kind: "folder", folder_token: folder.token, folder_name: folder.name }, `${folder.name}/`, config.my_space.max_depth));
+    }
+    if (config.wiki.enabled) {
+        yield* emit(walkWiki(client, config.wiki.exclude_space_ids));
+    }
+}
+//# sourceMappingURL=walkers.js.map

package/dist/collectors/feishu/docs/walkers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"walkers.js","sourceRoot":"","sources":["../../../../src/collectors/feishu/docs/walkers.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAuB,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAIhG;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,eAAe,CACpC,MAAyB,EACzB,WAAmB,EACnB,MAAuB,EACvB,UAAkB,EAClB,QAAgB;IAEhB,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,MAAM,CAAC,QAAQ,CAAkB,2BAA2B,EAAE;QACrF,YAAY,EAAE,WAAW;QACzB,SAAS,EAAE,IAAI;KAChB,CAAC,EAAE,CAAC;QACH,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC9B,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC3B,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;oBACjB,KAAK,CAAC,CAAC,eAAe,CACpB,MAAM,EACN,IAAI,CAAC,KAAK,EACV,MAAM,EACN,GAAG,UAAU,GAAG,IAAI,CAAC,IAAI,GAAG,EAC5B,QAAQ,GAAG,CAAC,CACb,CAAC;gBACJ,CAAC;gBACD,SAAS;YACX,CAAC;YACD,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM;gBAAE,SAAS;YACnC,MAAM,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;AACH,CAAC;AAOD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,QAAQ,CAC7B,MAAyB,EACzB,eAAyB;IAEzB,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,eAAe,CAAC,CAAC;IAC1C,IAAI,KAAK,EAAE,MAAM,SAAS,IAAI,MAAM,CAAC,QAAQ,CAAkB,2BAA2B,CAAC,EAAE,CAAC;QAC5F,KAAK,MAAM,KAAK,IAAI,SAAS,CAAC,KAAK,EAAE,CAAC;YACpC,IAAI,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC;gBAAE,SAAS;YAC3C,IAAI,KAAK,EAAE,MAAM,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAC1C,6BAA6B,KAAK,CAAC,QAAQ,QAAQ,CACpD,EAAE,CAAC;gBACF,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;oBAClC,IAAI,IAAI,CAAC,QAAQ,KAAK,MAAM;wBAAE,SAAS;oBACvC,MAAM,mBAAmB,CACvB,IAAI,EACJ;wBACE,IAAI,EAAE,MAAM;wBACZ,QAAQ,EAAE,KAAK,CAAC,QAAQ;wBACxB,UAAU,EAAE,KAAK,CAAC,IAAI;wBACtB,UAAU,EAAE,IAAI,CAAC,UAAU;qBAC5B,EACD,QAAQ,KAAK,CAAC,IAAI,GAAG,CACtB,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,KAAK,UAAU,cAAc,CAAC,MAAyB;IACrD,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,OAAO,CAC9B,KAAK,EACL,+CAA+C,CAChD,CAAC;IACF,OAAO,GAAG,CAAC,IAAI,EAAE,KAAK,IAAI,IAAI,CAAC;AACjC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,iBAAiB,CACtC,MAAyB,EACzB,MAA0B;IAE1B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE/B,MAAM,IAAI,GAAG,KAAK,SAAS,CAAC,EAAE,GAAiC;QAC7D,IAAI,KAAK,EAAE,MAAM,CAAC,IAAI,GAAG,EAAE,CAAC;YAC1B,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;gBAAE,SAAS;YACpC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;YACtB,MAAM,CAAC,CAAC;QACV,CAAC;IACH,CAAC,CAAC;IAEF,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,MAAM,CAAC,CAAC;QAC1C,IAAI,IAAI,EAAE,CAAC;YACT,KAAK,CAAC,CAAC,IAAI,CACT,eAAe,CACb,MAAM,EACN,IAAI,EACJ,EAAE,IAAI,EAAE,UAAU,EAAE,YAAY,EAAE,IAAI,EAAE,EACxC,WAAW,EACX,MAAM,CAAC,QAAQ,CAAC,SAAS,CAC1B,CACF,CAAC;QACJ,CAAC;IACH,CAAC;IAED,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACpC,KAAK,CAAC,CAAC,IAAI,CACT,eAAe,CACb,MAAM,EACN,MAAM,CAAC,KAAK,EACZ,EAAE,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,CAAC,IAAI,EAAE,EACxE,GAAG,MAAM,CAAC,IAAI,GAAG,EACjB,MAAM,CAAC,QAAQ,CAAC,SAAS,CAC1B,CACF,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QACxB,KAAK,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC;IAC/D,CAAC;AACH,CAAC"}

package/dist/collectors/feishu/docs/wiki-resolver.d.ts

@@ -0,0 +1,15 @@
+import type { IFeishuHttpClient } from "../http-client.js";
+export declare class WikiNodeNotFoundError extends Error {
+    node_token: string;
+    constructor(node_token: string);
+}
+/**
+ * CALIBRATED 2026-06-14: GET /open-apis/wiki/v2/spaces/get_node returns the node
+ * under data.node, carrying obj_token/obj_type (same fields seen live on the
+ * wiki/v2/spaces/<id>/nodes rows — see probe-fixtures.md wiki_node_row).
+ */
+export declare function resolveWikiNode(client: IFeishuHttpClient, nodeToken: string): Promise<{
+    obj_token: string;
+    obj_type: string;
+}>;
+//# sourceMappingURL=wiki-resolver.d.ts.map

package/dist/collectors/feishu/docs/wiki-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki-resolver.d.ts","sourceRoot":"","sources":["../../../../src/collectors/feishu/docs/wiki-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,qBAAa,qBAAsB,SAAQ,KAAK;IAC3B,UAAU,EAAE,MAAM;gBAAlB,UAAU,EAAE,MAAM;CAItC;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,iBAAiB,EACzB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAYlD"}

package/dist/collectors/feishu/docs/wiki-resolver.js

@@ -0,0 +1,24 @@
+export class WikiNodeNotFoundError extends Error {
+    node_token;
+    constructor(node_token) {
+        super(`Wiki node not found: ${node_token}`);
+        this.node_token = node_token;
+        this.name = "WikiNodeNotFoundError";
+    }
+}
+/**
+ * CALIBRATED 2026-06-14: GET /open-apis/wiki/v2/spaces/get_node returns the node
+ * under data.node, carrying obj_token/obj_type (same fields seen live on the
+ * wiki/v2/spaces/<id>/nodes rows — see probe-fixtures.md wiki_node_row).
+ */
+export async function resolveWikiNode(client, nodeToken) {
+    const res = await client.request("GET", "/open-apis/wiki/v2/spaces/get_node", {
+        params: { token: nodeToken, obj_type: "wiki" },
+    });
+    const node = res.data?.node;
+    if (!node?.obj_token || !node.obj_type) {
+        throw new WikiNodeNotFoundError(nodeToken);
+    }
+    return { obj_token: node.obj_token, obj_type: node.obj_type };
+}
+//# sourceMappingURL=wiki-resolver.js.map

package/dist/collectors/feishu/docs/wiki-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki-resolver.js","sourceRoot":"","sources":["../../../../src/collectors/feishu/docs/wiki-resolver.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC3B;IAAnB,YAAmB,UAAkB;QACnC,KAAK,CAAC,wBAAwB,UAAU,EAAE,CAAC,CAAC;QAD3B,eAAU,GAAV,UAAU,CAAQ;QAEnC,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAAyB,EACzB,SAAiB;IAEjB,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,OAAO,CAG7B,KAAK,EAAE,oCAAoC,EAAE;QAC9C,MAAM,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE;KAC/C,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC;IAC5B,IAAI,CAAC,IAAI,EAAE,SAAS,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACvC,MAAM,IAAI,qBAAqB,CAAC,SAAS,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC;AAChE,CAAC"}

package/dist/collectors/feishu/http-client.d.ts

@@ -0,0 +1,26 @@
+import type { FeishuAuthManager } from "./auth.js";
+import type { FeishuRateLimiter } from "./rate-limiter.js";
+export interface PagedResult<T = Record<string, unknown>> {
+    items: T[];
+    has_more: boolean;
+    page_token?: string;
+}
+export interface IFeishuHttpClient {
+    request<T = unknown>(method: string, path: string, options?: {
+        params?: Record<string, string>;
+        body?: unknown;
+    }): Promise<T>;
+    paginate<T = Record<string, unknown>>(path: string, params?: Record<string, string>): AsyncGenerator<PagedResult<T>>;
+}
+export declare class FeishuHttpClient implements IFeishuHttpClient {
+    private readonly auth;
+    private readonly rateLimiter;
+    constructor(auth: FeishuAuthManager, rateLimiter: FeishuRateLimiter);
+    request<T = unknown>(method: string, path: string, options?: {
+        params?: Record<string, string>;
+        body?: unknown;
+    }): Promise<T>;
+    paginate<T = Record<string, unknown>>(path: string, params?: Record<string, string>): AsyncGenerator<PagedResult<T>>;
+    private backoff;
+}
+//# sourceMappingURL=http-client.d.ts.map

package/dist/collectors/feishu/http-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../../../src/collectors/feishu/http-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAW3D,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACtD,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,CAAC,GAAG,OAAO,EACjB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,GAC5D,OAAO,CAAC,CAAC,CAAC,CAAC;IAEd,QAAQ,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,cAAc,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;CACnC;AAED,qBAAa,gBAAiB,YAAW,iBAAiB;IAEtD,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,WAAW;gBADX,IAAI,EAAE,iBAAiB,EACvB,WAAW,EAAE,iBAAiB;IAG3C,OAAO,CAAC,CAAC,GAAG,OAAO,EACvB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,GAC5D,OAAO,CAAC,CAAC,CAAC;IAwEN,QAAQ,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACzC,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,cAAc,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;YAkBnB,OAAO;CAItB"}