dsh-industry-research 0.1.0

package/lib/types/timeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline.d.ts","sourceRoot":"","sources":["../../src/timeline.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,2DAA2D;AAC3D,MAAM,MAAM,aAAa,GAAG;IAC1B,kGAAkG;IAClG,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,gBAAgB;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,6BAA6B;IAC7B,GAAG,EAAE,MAAM,CAAA;IACX,6DAA6D;IAC7D,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,iHAAiH;IACjH,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,iEAAiE;IACjE,UAAU,EAAE,MAAM,CAAA;IAClB,8CAA8C;IAC9C,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,+DAA+D;IAC/D,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAED,qDAAqD;AACrD,MAAM,WAAW,aAAa;IAC5B,4CAA4C;IAC5C,KAAK,EAAE,aAAa,EAAE,CAAA;IACtB,mEAAmE;IACnE,UAAU,EAAE,MAAM,CAAA;IAClB,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAA;IACb,+DAA+D;IAC/D,SAAS,EAAE,OAAO,CAAA;CACnB;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAehD;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,MAAM,EAAE,EAAE,SAAS,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAe9G;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,aAAa,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAsBvG;AAED;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,aAAa,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAoB7H"}

package/lib/types/timeline.js

@@ -0,0 +1,129 @@
+/**
+ * The per-industry timeline store (`timeline.jsonl`): one JSON entry per line,
+ * appended by `industry_track`, deduplicated by normalized URL, and capped by
+ * `timelineMaxEntries` (oldest entries dropped first). Pure file store — the
+ * web retrieval policy lives in `tools/track.ts`.
+ * @module dsh-industry-research/timeline
+ */
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { dirname } from 'node:path';
+/**
+ * Normalize a URL for dedupe: lowercase scheme and host, strip default ports,
+ * strip a lone trailing slash on the path. Unparseable URLs are returned
+ * verbatim (dedupe then falls back to exact string equality).
+ * @param url - the raw URL.
+ * @returns the normalized dedupe key.
+ */
+export function normalizeUrl(url) {
+    try {
+        const parsed = new URL(url);
+        parsed.protocol = parsed.protocol.toLowerCase();
+        parsed.hostname = parsed.hostname.toLowerCase();
+        if ((parsed.protocol === 'https:' && parsed.port === '443') || (parsed.protocol === 'http:' && parsed.port === '80')) {
+            parsed.port = '';
+        }
+        if (parsed.pathname.length > 1 && parsed.pathname.endsWith('/')) {
+            parsed.pathname = parsed.pathname.slice(0, -1);
+        }
+        return parsed.toString();
+    }
+    catch {
+        return url;
+    }
+}
+/**
+ * Decide whether a source URL passes the host allow/block lists. Entries are
+ * host suffixes (`gov.cn` matches `www.gov.cn`) or URL prefixes
+ * (`https://www.gov.cn/zhengce/`). The blocklist wins. An empty allowlist
+ * allows every host.
+ * @param url - the candidate URL.
+ * @param allowlist - configured allow entries.
+ * @param blocklist - configured block entries.
+ * @returns whether the URL may be tracked.
+ */
+export function sourceAllowed(url, allowlist, blocklist) {
+    let host = '';
+    try {
+        host = new URL(url).hostname.toLowerCase();
+    }
+    catch {
+        host = '';
+    }
+    const matches = (entry) => {
+        const normalized = entry.toLowerCase();
+        if (normalized.includes('://'))
+            return url.toLowerCase().startsWith(normalized);
+        return host === normalized || host.endsWith(`.${normalized}`);
+    };
+    if (blocklist.some(matches))
+        return false;
+    if (allowlist.length === 0)
+        return true;
+    return allowlist.some(matches);
+}
+/**
+ * Read a timeline store, tolerating a missing file. Corrupt lines are skipped
+ * and counted (never silently: the caller surfaces the count), because a
+ * single torn line must not drop the rest of a durable log.
+ * @param path - absolute path of the JSONL file.
+ * @returns the parsed entries plus the number of skipped corrupt lines.
+ */
+export async function readTimeline(path) {
+    let text;
+    try {
+        text = await readFile(path, 'utf8');
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return { entries: [], corrupt: 0 };
+        throw error;
+    }
+    const entries = [];
+    let corrupt = 0;
+    for (const line of text.split('\n')) {
+        const trimmed = line.trim();
+        if (trimmed.length === 0)
+            continue;
+        try {
+            const parsed = JSON.parse(trimmed);
+            if (typeof parsed.url !== 'string' || typeof parsed.title !== 'string')
+                throw new Error('missing fields');
+            entries.push(parsed);
+        }
+        catch {
+            corrupt += 1;
+        }
+    }
+    return { entries, corrupt };
+}
+/**
+ * Merge a batch into the store and persist: dedupe by normalized URL (both
+ * against the store and within the batch), append the survivors, and rewrite
+ * the file keeping only the newest `maxEntries` when the cap is exceeded.
+ * @param path - absolute path of the JSONL file.
+ * @param batch - candidate entries, in arrival order.
+ * @param maxEntries - retention cap (oldest dropped first).
+ * @returns the merge outcome.
+ */
+export async function mergeTimeline(path, batch, maxEntries) {
+    const { entries } = await readTimeline(path);
+    const seen = new Set(entries.map(entry => normalizeUrl(entry.url)));
+    const added = [];
+    let duplicates = 0;
+    for (const entry of batch) {
+        const key = normalizeUrl(entry.url);
+        if (seen.has(key)) {
+            duplicates += 1;
+            continue;
+        }
+        seen.add(key);
+        added.push(entry);
+    }
+    const merged = [...entries, ...added];
+    const kept = merged.length > maxEntries ? merged.slice(merged.length - maxEntries) : merged;
+    const truncated = kept.length !== merged.length;
+    await mkdir(dirname(path), { recursive: true });
+    await writeFile(path, kept.map(entry => JSON.stringify(entry)).join('\n') + (kept.length > 0 ? '\n' : ''), 'utf8');
+    return { added, duplicates, total: kept.length, truncated };
+}
+//# sourceMappingURL=timeline.js.map

package/lib/types/timeline.js.map

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

package/lib/types/toolkit.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Shared helpers for the four research tools: workspace resolution from the
+ * calling agent's session and per-industry directory layout. The layout is:
+ *
+ * ```
+ * <cwd>/<industryRoot>/<industry>/chain.json      industry_map
+ * <cwd>/<industryRoot>/<industry>/timeline.jsonl  industry_track
+ * <cwd>/<industryRoot>/<industry>/sources.json    source registry
+ * <cwd>/<industryRoot>/<industry>/notes/          seed notes
+ * <cwd>/<industryRoot>/<industry>/reports/<ts>/   industry_report
+ * <cwd>/<industryRoot>/companies/<slug>/card.*    company_scan
+ * ```
+ * @module dsh-industry-research/toolkit
+ */
+import type { ToolRunContext } from '@deepseek-ai/dsh-tools';
+import type { ResolvedConfig } from './config.js';
+/**
+ * Resolve the session workspace the calling agent operates in. The tools are
+ * workspace-bound by design; without an agent-owned session cwd there is no
+ * honest place to persist artifacts, so this fails loud.
+ * @param exec - the tool execution context.
+ * @returns the absolute workspace root.
+ */
+export declare function workspaceOf(exec: ToolRunContext): string;
+/**
+ * Resolve and validate the directory of one industry under the configured
+ * root. The industry name is validated as a single safe path segment.
+ * @param config - resolved plugin config.
+ * @param cwd - absolute workspace root.
+ * @param industry - the raw industry argument.
+ * @returns `{ root, dir, name }` — absolute industry root, absolute industry directory, and the validated segment.
+ */
+export declare function industryDirOf(config: ResolvedConfig, cwd: string, industry: string): {
+    root: string;
+    dir: string;
+    name: string;
+};
+/**
+ * Resolve and validate the directory of one company card under the shared
+ * companies root.
+ * @param config - resolved plugin config.
+ * @param cwd - absolute workspace root.
+ * @param company - the raw company name argument.
+ * @returns `{ root, dir, slug }` — absolute industry root, absolute company directory, and the validated slug.
+ */
+export declare function companyDirOf(config: ResolvedConfig, cwd: string, company: string): {
+    root: string;
+    dir: string;
+    slug: string;
+};
+/** The `chain.json` path of an industry directory. */
+export declare function chainPathOf(dir: string): string;
+/** The `timeline.jsonl` path of an industry directory. */
+export declare function timelinePathOf(dir: string): string;
+/** The `sources.json` path of an industry directory. */
+export declare function sourcesPathOf(dir: string): string;
+/** The `notes/` directory of an industry directory. */
+export declare function notesDirOf(dir: string): string;
+/** The `reports/` directory of an industry directory. */
+export declare function reportsDirOf(dir: string): string;
+//# sourceMappingURL=toolkit.d.ts.map

package/lib/types/toolkit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolkit.d.ts","sourceRoot":"","sources":["../../src/toolkit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAGjD;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAMxD;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAIhI;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAI9H;AAED,sDAAsD;AACtD,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,0DAA0D;AAC1D,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,wDAAwD;AACxD,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,uDAAuD;AACvD,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,yDAAyD;AACzD,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD"}

package/lib/types/toolkit.js

@@ -0,0 +1,77 @@
+/**
+ * Shared helpers for the four research tools: workspace resolution from the
+ * calling agent's session and per-industry directory layout. The layout is:
+ *
+ * ```
+ * <cwd>/<industryRoot>/<industry>/chain.json      industry_map
+ * <cwd>/<industryRoot>/<industry>/timeline.jsonl  industry_track
+ * <cwd>/<industryRoot>/<industry>/sources.json    source registry
+ * <cwd>/<industryRoot>/<industry>/notes/          seed notes
+ * <cwd>/<industryRoot>/<industry>/reports/<ts>/   industry_report
+ * <cwd>/<industryRoot>/companies/<slug>/card.*    company_scan
+ * ```
+ * @module dsh-industry-research/toolkit
+ */
+import { join } from 'node:path';
+import { resolveContained, resolveIndustryRoot, safeSegment } from "./paths.js";
+/**
+ * Resolve the session workspace the calling agent operates in. The tools are
+ * workspace-bound by design; without an agent-owned session cwd there is no
+ * honest place to persist artifacts, so this fails loud.
+ * @param exec - the tool execution context.
+ * @returns the absolute workspace root.
+ */
+export function workspaceOf(exec) {
+    const cwd = exec.agent?.session.header.cwd;
+    if (cwd === undefined || cwd.trim().length === 0) {
+        throw new Error('this tool requires an agent-owned session workspace (session.header.cwd is unset)');
+    }
+    return cwd;
+}
+/**
+ * Resolve and validate the directory of one industry under the configured
+ * root. The industry name is validated as a single safe path segment.
+ * @param config - resolved plugin config.
+ * @param cwd - absolute workspace root.
+ * @param industry - the raw industry argument.
+ * @returns `{ root, dir, name }` — absolute industry root, absolute industry directory, and the validated segment.
+ */
+export function industryDirOf(config, cwd, industry) {
+    const name = safeSegment('industry', industry);
+    const root = resolveIndustryRoot(cwd, config.industryRoot);
+    return { root, dir: resolveContained(root, name), name };
+}
+/**
+ * Resolve and validate the directory of one company card under the shared
+ * companies root.
+ * @param config - resolved plugin config.
+ * @param cwd - absolute workspace root.
+ * @param company - the raw company name argument.
+ * @returns `{ root, dir, slug }` — absolute industry root, absolute company directory, and the validated slug.
+ */
+export function companyDirOf(config, cwd, company) {
+    const slug = safeSegment('company', company);
+    const root = resolveIndustryRoot(cwd, config.industryRoot);
+    return { root, dir: join(root, 'companies', slug), slug };
+}
+/** The `chain.json` path of an industry directory. */
+export function chainPathOf(dir) {
+    return join(dir, 'chain.json');
+}
+/** The `timeline.jsonl` path of an industry directory. */
+export function timelinePathOf(dir) {
+    return join(dir, 'timeline.jsonl');
+}
+/** The `sources.json` path of an industry directory. */
+export function sourcesPathOf(dir) {
+    return join(dir, 'sources.json');
+}
+/** The `notes/` directory of an industry directory. */
+export function notesDirOf(dir) {
+    return join(dir, 'notes');
+}
+/** The `reports/` directory of an industry directory. */
+export function reportsDirOf(dir) {
+    return join(dir, 'reports');
+}
+//# sourceMappingURL=toolkit.js.map

package/lib/types/toolkit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolkit.js","sourceRoot":"","sources":["../../src/toolkit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAGhC,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAE/E;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,IAAoB;IAC9C,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,CAAA;IAC1C,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,KAAK,CAAC,mFAAmF,CAAC,CAAA;IACtG,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,MAAsB,EAAE,GAAW,EAAE,QAAgB;IACjF,MAAM,IAAI,GAAG,WAAW,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAA;IAC9C,MAAM,IAAI,GAAG,mBAAmB,CAAC,GAAG,EAAE,MAAM,CAAC,YAAY,CAAC,CAAA;IAC1D,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,gBAAgB,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,CAAA;AAC1D,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,MAAsB,EAAE,GAAW,EAAE,OAAe;IAC/E,MAAM,IAAI,GAAG,WAAW,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;IAC5C,MAAM,IAAI,GAAG,mBAAmB,CAAC,GAAG,EAAE,MAAM,CAAC,YAAY,CAAC,CAAA;IAC1D,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,CAAA;AAC3D,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,OAAO,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,CAAA;AAChC,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,OAAO,IAAI,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAA;AACpC,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,OAAO,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAA;AAClC,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,OAAO,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;AAC3B,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,OAAO,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAA;AAC7B,CAAC"}

package/lib/types/tools/company.d.ts

@@ -0,0 +1,36 @@
+/**
+ * The `company_scan` tool: scan one company from user-supplied workspace data
+ * files (primary) plus an optional `ctx.web` public-source complement, and
+ * persist a company card (`card.json` + `card.md`) whose every figure can be
+ * cited back to a file and a line. Paid/login-walled sources are out of scope
+ * — the user passes their exports in via `dataFiles`. v1 reads text formats
+ * only (no PDF).
+ * @module dsh-industry-research/tools/company
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { ResolvedConfig } from '../config.js';
+import type { CompanyCard } from '../company.js';
+/** The canonical value returned by `company_scan`. */
+export interface CompanyScanValue {
+    name: string;
+    slug: string;
+    /** Absolute company card directory. */
+    dir: string;
+    cardPath: string;
+    cardJsonPath: string;
+    /** The persisted card. */
+    card: CompanyCard;
+    /** Data files rejected this call, with the reason. */
+    rejected: Array<{
+        path: string;
+        reason: string;
+    }>;
+}
+/**
+ * Build the `company_scan` tool definition.
+ * @param ctx - the plugin context (optional web lookup).
+ * @param config - the resolved plugin config.
+ * @returns the tool definition to register.
+ */
+export declare function buildCompanyScanTool(ctx: Context, config: ResolvedConfig): import("@deepseek-ai/dsh-tools").ToolDefinition;
+//# sourceMappingURL=company.d.ts.map

package/lib/types/tools/company.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"company.d.ts","sourceRoot":"","sources":["../../../src/tools/company.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAElD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAElD,OAAO,KAAK,EAAiB,WAAW,EAAE,MAAM,eAAe,CAAA;AAK/D,sDAAsD;AACtD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,uCAAuC;IACvC,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE,MAAM,CAAA;IACpB,0BAA0B;IAC1B,IAAI,EAAE,WAAW,CAAA;IACjB,sDAAsD;IACtD,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAClD;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,mDAqHxE"}

package/lib/types/tools/company.js

@@ -0,0 +1,139 @@
+/**
+ * The `company_scan` tool: scan one company from user-supplied workspace data
+ * files (primary) plus an optional `ctx.web` public-source complement, and
+ * persist a company card (`card.json` + `card.md`) whose every figure can be
+ * cited back to a file and a line. Paid/login-walled sources are out of scope
+ * — the user passes their exports in via `dataFiles`. v1 reads text formats
+ * only (no PDF).
+ * @module dsh-industry-research/tools/company
+ */
+import { defineTool } from '@deepseek-ai/dsh-tools';
+import { boundFigures, scanFile, writeCard } from "../company.js";
+import { lookupWeb, requestSignal, webErrorMessage } from "../web.js";
+import { resolveWorkspaceFile } from "../paths.js";
+import { companyDirOf, workspaceOf } from "../toolkit.js";
+/**
+ * Build the `company_scan` tool definition.
+ * @param ctx - the plugin context (optional web lookup).
+ * @param config - the resolved plugin config.
+ * @returns the tool definition to register.
+ */
+export function buildCompanyScanTool(ctx, config) {
+    return defineTool({
+        name: 'company_scan',
+        description: '公司研究员的速览卡工具：以用户提供的工作区数据文件（年报摘录、数据表）为主、ctx.web 公开检索为辅，产出公司速览卡（业务结构 / 财务要点 / 风险点框架），所有数字都能标注来源文件与行号。不接付费/需登录数据源；缺口显式声明，禁止编造公司数字。仅供研究，不构成投资建议。',
+        parameters: {
+            name: { type: 'string', required: true, description: '公司名（作为目录段，如「样例酒业」）' },
+            dataFiles: { type: 'array', items: { type: 'string' }, description: '工作区内数据文件的相对路径列表（.md/.txt/.csv/.tsv/.json；v1 不解析 PDF）' },
+            web: { type: 'boolean', description: '是否做 web 公开源补充检索（默认 true；config.offline 时自动跳过）' },
+        },
+        output: {
+            schema: {
+                type: 'object',
+                properties: {
+                    name: { type: 'string', required: true },
+                    slug: { type: 'string', required: true },
+                    dir: { type: 'string', required: true },
+                    cardPath: { type: 'string', required: true },
+                    cardJsonPath: { type: 'string', required: true },
+                    card: { type: 'json', required: true },
+                    rejected: { type: 'array', items: { type: 'json' }, required: true },
+                },
+                additionalProperties: false,
+            },
+            render: (_args, value) => {
+                const current = value;
+                const card = current.card;
+                const lines = [
+                    `公司速览卡「${card.name}」→ ${current.cardPath}`,
+                    `数据文件 ${card.sources.length} 份，数字候选行 ${card.figureCandidates.length} 行（引用数字必须标注文件与行号）。`,
+                ];
+                if (card.webSources !== null && card.webSources.length > 0) {
+                    lines.push(`公开源 ${card.webSources.length} 条：${card.webSources.map(source => source.title ?? source.url).join('；')}`);
+                }
+                if (current.rejected.length > 0) {
+                    lines.push(`未采纳文件 ${current.rejected.length} 份：${current.rejected.map(entry => `${entry.path}（${entry.reason}）`).join('；')}`);
+                }
+                if (card.gaps.length > 0)
+                    lines.push(`缺口声明：${card.gaps.join('；')}`);
+                return [{ type: 'text', text: lines.join('\n') }];
+            },
+        },
+        timeoutMs: Math.max(30_000, config.fetchTimeoutMs * 3),
+        async execute(args, exec) {
+            const cwd = workspaceOf(exec);
+            const { dir, slug } = companyDirOf(config, cwd, args.name);
+            const now = new Date().toISOString();
+            const gaps = [];
+            const rejected = [];
+            const scanned = [];
+            for (const file of args.dataFiles ?? []) {
+                let absolute;
+                try {
+                    absolute = resolveWorkspaceFile(cwd, file);
+                }
+                catch (error) {
+                    throw error;
+                }
+                try {
+                    scanned.push(await scanFile(absolute, config.scan.maxFileBytes));
+                }
+                catch (error) {
+                    rejected.push({ path: file, reason: error instanceof Error ? error.message : String(error) });
+                }
+            }
+            if ((args.dataFiles ?? []).length === 0) {
+                gaps.push('未提供数据文件（dataFiles）：业务结构 / 财务要点 / 风险点均待补');
+            }
+            let webSources = null;
+            if (args.web === false) {
+                gaps.push('按调用方要求未做 web 公开源检索');
+            }
+            else if (config.offline) {
+                gaps.push('config.offline 为 true，未做 web 公开源检索');
+            }
+            else {
+                const web = lookupWeb(ctx);
+                if (web === undefined) {
+                    gaps.push('ctx.web 未挂载，未做 web 公开源检索');
+                }
+                else {
+                    try {
+                        const outcome = await web.search({ query: `${args.name} 公司 业务 简介`, maxResults: 5 }, requestSignal(exec.signal, config.fetchTimeoutMs));
+                        webSources = outcome.sources.map(source => ({
+                            url: source.url,
+                            ...(source.title !== undefined ? { title: source.title } : {}),
+                            ...(source.snippet !== undefined ? { snippet: source.snippet } : {}),
+                            ...(source.publishedAt !== undefined ? { publishedAt: source.publishedAt } : {}),
+                        }));
+                    }
+                    catch (error) {
+                        gaps.push(`web 公开源检索失败：${webErrorMessage(error)}`);
+                    }
+                }
+            }
+            const figures = boundFigures(scanned.flatMap(file => file.figures), config);
+            const totalFigures = scanned.reduce((sum, file) => sum + file.figures.length, 0);
+            if (totalFigures > figures.length) {
+                gaps.push(`数字候选行超出 scan.maxFigureCandidates（${totalFigures} > ${figures.length}），仅保留前 ${figures.length} 行`);
+            }
+            if (scanned.length > 0 && totalFigures === 0) {
+                gaps.push('数据文件中未发现数字行：财务要点待补');
+            }
+            const card = {
+                name: args.name.trim(),
+                slug,
+                asOf: now,
+                sources: scanned.map(file => file.source),
+                outline: scanned.flatMap(file => file.outline !== undefined ? [file.outline] : []),
+                figureCandidates: figures,
+                webSources,
+                gaps,
+                disclaimer: '仅供研究，不构成投资建议',
+            };
+            const { cardJsonPath, cardPath } = await writeCard(dir, card);
+            return { name: card.name, slug, dir, cardPath, cardJsonPath, card, rejected };
+        },
+    });
+}
+//# sourceMappingURL=company.js.map

package/lib/types/tools/company.js.map

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

package/lib/types/tools/map.d.ts

@@ -0,0 +1,44 @@
+/**
+ * The `industry_map` tool: build or update one industry's chain map. The
+ * model authors the ChainMap (guided by the industry-research-method skill);
+ * the tool validates it (dangling edges, unsourced numbers, illegal tiers),
+ * persists `chain.json`, registers seed/web material as citable sources, and
+ * lists the explicit gap slots. Called without a `chain` argument it returns
+ * the current map plus the registered sources, so the model can iterate.
+ * @module dsh-industry-research/tools/map
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { ResolvedConfig } from '../config.js';
+import type { ChainMap } from '../chain.js';
+import type { SourceEntry } from '../sources.js';
+import type { WebSource } from '../web.js';
+/** The canonical value returned by `industry_map`. */
+export interface IndustryMapValue {
+    industry: string;
+    /** Absolute industry directory. */
+    dir: string;
+    /** Absolute path of `chain.json` (present once a map was committed). */
+    chainPath: string;
+    /** Whether this call committed a new map. */
+    updated: boolean;
+    /** The current map after this call; null when none exists yet. */
+    chain: ChainMap | null;
+    /** Explicit gap slots of the current map. */
+    gaps: string[];
+    /** All registered citable sources of this industry. */
+    sources: SourceEntry[];
+    /** Refs registered by this call (seed note, seed files, web digest). */
+    seedRefs: string[];
+    /** Web-assist digest; null when the assist did not run. */
+    webDigest: WebSource[] | null;
+    /** Why the web assist did not run; null when it ran or was not requested. */
+    webNote: string | null;
+}
+/**
+ * Build the `industry_map` tool definition.
+ * @param ctx - the plugin context (event emission + optional web lookup).
+ * @param config - the resolved plugin config.
+ * @returns the tool definition to register.
+ */
+export declare function buildIndustryMapTool(ctx: Context, config: ResolvedConfig): import("@deepseek-ai/dsh-tools").ToolDefinition;
+//# sourceMappingURL=map.d.ts.map

package/lib/types/tools/map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map.d.ts","sourceRoot":"","sources":["../../../src/tools/map.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAElD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAElD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAE3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAEhD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAK1C,sDAAsD;AACtD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAA;IAChB,mCAAmC;IACnC,GAAG,EAAE,MAAM,CAAA;IACX,wEAAwE;IACxE,SAAS,EAAE,MAAM,CAAA;IACjB,6CAA6C;IAC7C,OAAO,EAAE,OAAO,CAAA;IAChB,kEAAkE;IAClE,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAA;IACtB,6CAA6C;IAC7C,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,uDAAuD;IACvD,OAAO,EAAE,WAAW,EAAE,CAAA;IACtB,wEAAwE;IACxE,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,2DAA2D;IAC3D,SAAS,EAAE,SAAS,EAAE,GAAG,IAAI,CAAA;IAC7B,6EAA6E;IAC7E,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CACvB;AAsDD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,mDAsIxE"}