@danceiny/gotry 0.0.1-rc.9 → 0.2.0-rc.27

package/ts/dsh-runtime/vendor/dsh-map-tools/lib/index.js

@@ -0,0 +1,120 @@
+import { AmapClient } from './clients/amap.js';
+import { OsrmClient } from './clients/osrm.js';
+import { NominatimClient } from './clients/nominatim.js';
+import { PhotonClient } from './clients/photon.js';
+import { registerRouteTools } from './tools/routes.js';
+import { registerGeocodeTools } from './tools/geocode.js';
+import { registerPoiTool } from './tools/poi.js';
+import { parseLngLat } from './types.js';
+import { Config } from './config.js';
+import { readConfig } from './config-file.js';
+import { installConfigRoute } from './config-route.js';
+import { installStaticMapRoute } from './staticmap-route.js';
+import { installSettingsNamespace } from './settings-ns.js';
+export const name = 'dsh-map-tools';
+export const inject = ['tools'];
+export { Config };
+/** Build (or rebuild) the provider clients. Priority: config-file (settings
+ * card) → schema defaults. */
+function buildClients(config) {
+    // The settings card writes ~/.dsh-map-tools/config.json; when it holds
+    // values, they win over the composition-entry schema defaults.
+    let fileConfig = {};
+    try {
+        fileConfig = readConfig();
+    }
+    catch (error) {
+        console.error(`[dsh-map-tools] config read failed, using schema defaults: ${error}`);
+    }
+    const provider = fileConfig.provider ?? config.provider;
+    const amapKey = fileConfig.amapKey ?? config.amapKey;
+    const timeoutMs = fileConfig.timeoutMs ?? config.timeoutMs;
+    const maxQps = fileConfig.maxQps ?? config.maxQps;
+    // Provider selection: exactly one primary source per provider.
+    const amap = provider === 'amap' && amapKey
+        ? new AmapClient({ key: amapKey, timeoutMs, maxQps })
+        : undefined;
+    const osrm = new OsrmClient({ timeoutMs });
+    const nominatim = new NominatimClient({
+        timeoutMs,
+        userAgent: 'dsh-map-tools/0.1.0 (DeepSeek Harness plugin; contact: https://github.com/HorusJiang/dsh-map-tools)',
+    });
+    const photon = new PhotonClient({ timeoutMs, lang: config.language });
+    /** Resolve an address (or `lng,lat`) to coordinates, using the active provider. */
+    async function resolve(text, signal) {
+        const coord = parseLngLat(text);
+        if (coord)
+            return coord;
+        if (amap) {
+            const r = await amap.geocode(text, signal);
+            return r.location;
+        }
+        // Free sources cannot reliably geocode Chinese addresses (Nominatim is
+        // blocked on many CN networks, Photon returns 400 for CJK queries) — give
+        // an actionable prompt instead of a raw provider error.
+        throw new Error(`免费数据源无法可靠解析中文地址："${text}"。请直接提供 "lng,lat" 坐标，或在插件配置中设置高德 amapKey（https://console.amap.com/dev/key/app）。`);
+    }
+    /** Resolve the city code for a point (transit queries need city1/city2).
+     *  Amap v5 transit accepts only an adcode (e.g. "110000" / "110101") or a
+     *  citycode (e.g. "010") — bare city names like "北京" are rejected with
+     *  INVALID_PARAMS. Prefer the adcode from geocoding; fall back to the city
+     *  name as a last resort. */
+    async function resolveCity(text, signal) {
+        const coord = parseLngLat(text);
+        if (amap) {
+            const r = coord ? await amap.reverseGeocode(coord, signal) : await amap.geocode(text, signal);
+            if (r.adcode)
+                return r.adcode;
+            const city = r.city ?? '';
+            return city.replace(/市$/, '');
+        }
+        return '';
+    }
+    return { amap, osrm, nominatim, photon, resolve, resolveCity };
+}
+/** Register every tool under the current clients; returns a disposer. */
+function registerAll(ctx, clients) {
+    const disposers = [];
+    const routeClients = {
+        amap: clients.amap,
+        osrm: clients.osrm,
+        resolve: clients.resolve,
+        resolveCity: clients.resolveCity,
+        defaultMode: 'driving',
+    };
+    registerRouteTools(ctx, routeClients, disposers);
+    registerGeocodeTools(ctx, { amap: clients.amap, nominatim: clients.nominatim, photon: clients.photon }, disposers);
+    registerPoiTool(ctx, { amap: clients.amap, resolve: clients.resolve }, disposers);
+    return () => {
+        for (const d of disposers)
+            d();
+    };
+}
+export function apply(ctx, config) {
+    // Register tools under an effect: Cordis runs the returned disposer both on
+    // explicit reload (we call it) and on plugin unload (fiber disposal).
+    let disposeTools = () => { };
+    /** 当前生效的客户端集合；静态地图回环路由按需读它（保存配置后会被替换）。 */
+    let current;
+    ctx.effect(() => {
+        current = buildClients(config);
+        disposeTools = registerAll(ctx, current);
+        return () => {
+            disposeTools();
+            current = undefined;
+        };
+    });
+    const reload = () => {
+        disposeTools();
+        current = buildClients(config);
+        disposeTools = registerAll(ctx, current);
+    };
+    // The settings card route + namespace (modlens pattern): the card reads and
+    // writes ~/.dsh-map-tools/config.json through the loopback route, and the
+    // tools rebuild on a save (route POST → reload).
+    installConfigRoute(ctx, reload);
+    // 卡片要的静态地图（真地图 + 高德绘制的路线）也走回环路由：key 留在宿主，
+    // 浏览器只拿图片。没有 amapKey 时路由返回 409，卡片自动退回自绘示意图。
+    installStaticMapRoute(ctx, () => current?.amap);
+    installSettingsNamespace(ctx, config, reload);
+}

package/ts/dsh-runtime/vendor/dsh-map-tools/lib/settings-ns.js

@@ -0,0 +1,40 @@
+import { Config as ConfigSchema } from './config.js';
+/** Namespace the settings page keys this plugin's card to (plain string since DSH 0.1.2-rc.1). */
+export const MAP_TOOLS_NS = 'dsh-map-tools';
+/**
+ * Wire the settings section so the card renders. The values live in the
+ * config file; the section carries only the composition entry as its base so
+ * the page has something to dispatch on.
+ *
+ * GoTry vendored adaptation for DSH 0.2.0-rc.2: SettingsForms replaced the
+ * manual per-section API — forms now auto-generate from the plugin's exported
+ * Config schema, and the only manual registration left is the page policy via
+ * `settings.configure({ auto }, ownerFiber)`. Legacy hosts (installSection)
+ * keep the historical wiring so the same build runs on both release lines.
+ *
+ * @param ctx - plugin context.
+ * @param entry - the composition entry config (schema defaults).
+ * @param reload - rebuild tools after a settings change.
+ */
+export function installSettingsNamespace(ctx, entry, reload) {
+    ctx.inject(['settings'], (scope) => {
+        if (typeof scope.settings.configure === 'function') {
+            const dispose = scope.settings.configure({ auto: true }, ctx.fiber);
+            if (typeof dispose === 'function' && typeof ctx.effect === 'function') {
+                ctx.effect(() => dispose);
+            }
+            return;
+        }
+        scope.settings.installSection(ctx, MAP_TOOLS_NS, ConfigSchema, entry, {
+            setSource: (current) => {
+                // The tools read ~/.dsh-map-tools/config.json then the composition
+                // entry; the section's own value is a dispatch key for the card and
+                // is never a tool configuration source.
+                void current;
+            },
+            onChange: () => {
+                reload();
+            },
+        });
+    });
+}

package/ts/dsh-runtime/vendor/dsh-map-tools/lib/staticmap-route.js

@@ -0,0 +1,115 @@
+/**
+ * Loopback route serving the route-card's static map image.
+ *
+ * GET /dsh-map-tools/staticmap?w=640&h=260&line=lng,lat;lng,lat;…
+ *
+ * 为什么走回环路由而不是把图片塞进工具结果：
+ *   1. **key 不出宿主**——浏览器只拿到一张本地图片 URL，高德 key 始终在服务端；
+ *   2. **不进模型上下文**——工具结果里放 image block 会被适配器跳过/或消耗
+ *      视觉额度，而卡片要的只是一张示意图；
+ *   3. **懒加载 + 可缓存**——只有卡片真正渲染时才取图，且服务端按参数缓存。
+ *
+ * 拿不到图（没 key / 配额超限 / 网络问题）时返回错误状态码，客户端卡片会
+ * 自动降级为自绘示意图（client/client.js 里的 svg 兜底）。
+ */
+import { parseLngLat } from './types.js';
+import { isTrustedRequest } from './config-route.js';
+/** URL 里最多接受的坐标点数（再多就截断，避免超长 query）。 */
+const MAX_POINTS = 160;
+/** 画布尺寸上限，与高德静态地图的限制一致。 */
+const MAX_SIDE = 1024;
+/** 解析 `line=lng,lat;lng,lat;…`；非法片段跳过，超过上限则等间隔截断。 */
+export function parseLineParam(raw) {
+    if (raw === null || raw === '')
+        return [];
+    const points = [];
+    for (const chunk of raw.split(';')) {
+        const point = parseLngLat(chunk);
+        if (point !== null)
+            points.push(point);
+    }
+    if (points.length <= MAX_POINTS)
+        return points;
+    const out = [];
+    const step = (points.length - 1) / (MAX_POINTS - 1);
+    for (let i = 0; i < MAX_POINTS; i += 1)
+        out.push(points[Math.round(i * step)]);
+    return out;
+}
+/** 把尺寸参数钳制到合法范围（默认 640×260）。 */
+export function parseSizeParam(w, h) {
+    const clamp = (value, fallback) => {
+        const n = Number(value);
+        if (!Number.isFinite(n) || n <= 0)
+            return fallback;
+        return Math.max(64, Math.min(MAX_SIDE, Math.round(n)));
+    };
+    return { width: clamp(w, 640), height: clamp(h, 260) };
+}
+/**
+ * Register the static-map route under the web server, when one exists.
+ *
+ * @param ctx - plugin context.
+ * @param getAmap - reads the current Amap client (rebuilt on every config save).
+ */
+export function installStaticMapRoute(ctx, getAmap) {
+    const fn = ctx.inject;
+    fn(['webServer'], (scope) => {
+        // 同 config-route：register() 的 disposer 必须由 effect 持有，否则热替换后
+        // 旧处理器留在 exact 表里、新注册撞 "duplicate route" 被静默吞掉。
+        scope.effect(() => scope.webServer.register({
+            kind: 'exact',
+            path: '/dsh-map-tools/staticmap',
+            handler: async (req, res) => {
+                const fail = (status, message) => {
+                    res.writeHead(status, { 'content-type': 'text/plain; charset=utf-8', 'cache-control': 'no-store' });
+                    res.end(message);
+                };
+                if (!isTrustedRequest(req)) {
+                    fail(403, 'request refused: this route answers same-origin loopback only');
+                    return;
+                }
+                if (req.method !== 'GET' && req.method !== 'HEAD') {
+                    res.writeHead(405).end();
+                    return;
+                }
+                const url = new URL(req.url ?? '/', 'http://localhost');
+                const line = parseLineParam(url.searchParams.get('line'));
+                if (line.length < 2) {
+                    fail(400, '需要至少两个坐标点：/dsh-map-tools/staticmap?line=lng,lat;lng,lat');
+                    return;
+                }
+                const amap = getAmap();
+                if (amap === undefined) {
+                    fail(409, '未配置高德 amapKey，静态地图不可用（卡片会退回自绘示意图）');
+                    return;
+                }
+                const size = parseSizeParam(url.searchParams.get('w'), url.searchParams.get('h'));
+                // Node 的 IncomingMessage 没有 signal：用连接关闭来取消上游请求
+                // （用户切走/刷新时不必继续烧配额）。
+                const controller = new AbortController();
+                const onClose = () => controller.abort(new Error('client closed the static-map request'));
+                req.on('close', onClose);
+                try {
+                    const png = await amap.staticMap(line, { width: size.width, height: size.height }, controller.signal);
+                    res.writeHead(200, {
+                        'content-type': 'image/png',
+                        'content-length': String(png.byteLength),
+                        // 同一张图（同一路线同尺寸）在客户端也缓存一天：回环流量几乎为零。
+                        'cache-control': 'private, max-age=86400',
+                    });
+                    if (req.method === 'HEAD')
+                        res.end();
+                    else
+                        res.end(Buffer.from(png));
+                }
+                catch (error) {
+                    fail(502, String(error?.message ?? error));
+                }
+                finally {
+                    req.off('close', onClose);
+                }
+            },
+        }));
+    });
+}

package/ts/dsh-runtime/vendor/dsh-map-tools/lib/tools/geocode.js

@@ -0,0 +1,127 @@
+/** Geocoding tools: address → coordinates, and reverse. */
+import { defineTool } from '@deepseek-ai/dsh-tools';
+import { parseLngLat } from '../types.js';
+export function registerGeocodeTools(ctx, clients, disposers = []) {
+    disposers.push(ctx.tools.register(defineTool({
+        name: 'map_geocode',
+        description: '把地址文本转换为经纬度坐标。支持中文地址、模糊地址。',
+        parameters: {
+            address: { type: 'string', required: true, description: '地址文本，如 "北京市朝阳区建国路88号"。' },
+        },
+        output: {
+            schema: {
+                type: 'object',
+                additionalProperties: false,
+                properties: {
+                    provider: { type: 'string' },
+                    formatted: { type: 'string' },
+                    location: {
+                        type: 'array',
+                        items: { type: 'number' },
+                    },
+                    city: { type: 'string' },
+                    district: { type: 'string' },
+                },
+            },
+            render: (_args, value) => {
+                const v = value;
+                const name = v.provider === 'amap' ? '高德' : v.provider === 'nominatim' ? 'Nominatim(OSM)' : v.provider === 'photon' ? 'Photon(OSM)' : 'inline';
+                const area = v.city ? `（${v.city}${v.district ? ` ${v.district}` : ''}）` : '';
+                return [{
+                        type: 'text',
+                        text: `${name} 解析 "${v.formatted}" → 经纬度 ${v.location[0]}, ${v.location[1]}${area}`,
+                    }];
+            },
+        },
+        async execute(args, exec) {
+            const coord = parseLngLat(args.address);
+            if (coord) {
+                // Input already looks like coordinates — return as-is.
+                return { provider: 'inline', formatted: args.address, location: coord };
+            }
+            if (clients.amap) {
+                const r = await clients.amap.geocode(args.address, exec.signal);
+                return { provider: r.provider, formatted: r.formatted, location: r.location, city: r.city, district: r.district };
+            }
+            // Free sources (Photon/Nominatim) are unreliable for Chinese addresses.
+            // Try them, but convert any failure into an actionable prompt.
+            let lastError = '免费地理编码服务不可用';
+            if (clients.photon) {
+                try {
+                    const r = await clients.photon.geocode(args.address, exec.signal);
+                    return { provider: r.provider, formatted: r.formatted, location: r.location, city: r.city, district: r.district };
+                }
+                catch (err) {
+                    lastError = err instanceof Error ? err.message : String(err);
+                }
+            }
+            if (clients.nominatim) {
+                try {
+                    const r = await clients.nominatim.geocode(args.address, exec.signal);
+                    return { provider: r.provider, formatted: r.formatted, location: r.location, city: r.city, district: r.district };
+                }
+                catch (err) {
+                    lastError = err instanceof Error ? err.message : String(err);
+                }
+            }
+            throw new Error(`免费数据源无法可靠解析中文地址："${args.address}"（${lastError}）。请直接提供 "lng,lat" 坐标，或在插件配置中设置高德 amapKey（https://console.amap.com/dev/key/app）。`);
+        },
+    })));
+    disposers.push(ctx.tools.register(defineTool({
+        name: 'map_reverse_geocode',
+        description: '把经纬度坐标转换为结构化地址（含城市、区县）。',
+        parameters: {
+            location: { type: 'string', required: true, description: '经纬度，格式 "lng,lat"，如 "116.397428,39.90923"。' },
+        },
+        output: {
+            schema: {
+                type: 'object',
+                additionalProperties: false,
+                properties: {
+                    provider: { type: 'string' },
+                    formatted: { type: 'string' },
+                    location: {
+                        type: 'array',
+                        items: { type: 'number' },
+                    },
+                    city: { type: 'string' },
+                    district: { type: 'string' },
+                },
+            },
+            render: (_args, value) => {
+                const v = value;
+                const name = v.provider === 'amap' ? '高德' : v.provider === 'nominatim' ? 'Nominatim(OSM)' : v.provider === 'photon' ? 'Photon(OSM)' : '未知';
+                return [{ type: 'text', text: `${name}：${v.formatted}` }];
+            },
+        },
+        async execute(args, exec) {
+            const coord = parseLngLat(args.location);
+            if (!coord)
+                throw new Error(`无效的经纬度格式：${args.location}（应为 "lng,lat"）`);
+            if (clients.amap) {
+                const r = await clients.amap.reverseGeocode(coord, exec.signal);
+                return { provider: r.provider, formatted: r.formatted, location: r.location, city: r.city, district: r.district };
+            }
+            let lastError = '免费地理编码服务不可用';
+            if (clients.photon) {
+                try {
+                    const r = await clients.photon.reverseGeocode(coord, exec.signal);
+                    return { provider: r.provider, formatted: r.formatted, location: r.location, city: r.city, district: r.district };
+                }
+                catch (err) {
+                    lastError = err instanceof Error ? err.message : String(err);
+                }
+            }
+            if (clients.nominatim) {
+                try {
+                    const r = await clients.nominatim.reverseGeocode(coord, exec.signal);
+                    return { provider: r.provider, formatted: r.formatted, location: r.location, city: r.city, district: r.district };
+                }
+                catch (err) {
+                    lastError = err instanceof Error ? err.message : String(err);
+                }
+            }
+            throw new Error(`免费逆地理编码服务不可用（${lastError}）。请配置高德 amapKey（https://console.amap.com/dev/key/app）以获得稳定结果。`);
+        },
+    })));
+}

package/ts/dsh-runtime/vendor/dsh-map-tools/lib/tools/poi.js

@@ -0,0 +1,84 @@
+/** POI search tool. */
+import { defineTool } from '@deepseek-ai/dsh-tools';
+import { parseLngLat } from '../types.js';
+export function registerPoiTool(ctx, clients, disposers = []) {
+    disposers.push(ctx.tools.register(defineTool({
+        name: 'map_poi_search',
+        description: '搜索兴趣点（POI）：餐厅、加油站、酒店、医院等。支持按关键词搜索或按位置周边搜索。',
+        parameters: {
+            keywords: { type: 'string', required: true, description: '搜索关键词，如 "加油站"、"咖啡"、"北京南站"。' },
+            location: {
+                type: 'string',
+                description: '中心点："lng,lat" 坐标或地址文本。提供后按周边搜索（默认半径 1000 米）。',
+            },
+            radiusM: { type: 'number', description: '周边搜索半径（米），默认 1000，最大 50000。' },
+            region: { type: 'string', description: '限定城市（文本搜索时），如 "北京"。' },
+            types: { type: 'string', description: 'POI 类型编码，如 "060000"（餐饮）。' },
+        },
+        output: {
+            schema: {
+                type: 'object',
+                additionalProperties: false,
+                properties: {
+                    count: { type: 'number' },
+                    results: {
+                        type: 'array',
+                        items: {
+                            type: 'object',
+                            additionalProperties: false,
+                            properties: {
+                                name: { type: 'string' },
+                                location: {
+                                    type: 'array',
+                                    items: { type: 'number' },
+                                },
+                                type: { type: 'string' },
+                                address: { type: 'string' },
+                                tel: { type: 'string' },
+                                distanceM: { type: 'number' },
+                            },
+                        },
+                    },
+                },
+            },
+            render: (_args, value) => {
+                const v = value;
+                const lines = [`找到 ${v.count} 个结果：`];
+                for (const r of v.results.slice(0, 10)) {
+                    const d = r.distanceM !== undefined ? `（距中心 ${Math.round(r.distanceM)} 米）` : '';
+                    const tel = r.tel ? ` 电话：${r.tel}` : '';
+                    lines.push(`- ${r.name}${d}${r.type ? ` [${r.type}]` : ''}${r.address ? ` ${r.address}` : ''}${tel}`);
+                }
+                if (v.results.length > 10)
+                    lines.push(`- …（还有 ${v.results.length - 10} 个）`);
+                return [{ type: 'text', text: lines.join('\n') }];
+            },
+        },
+        async execute(args, exec) {
+            if (!clients.amap)
+                throw new Error('POI 搜索需要配置高德 amapKey。申请：https://console.amap.com/dev/key/app');
+            let results;
+            if (args.location) {
+                const center = parseLngLat(args.location) ?? (await clients.resolve(args.location, exec.signal));
+                results = await clients.amap.poiAround(center, args.keywords, {
+                    radiusM: args.radiusM ?? 1000,
+                    types: args.types,
+                }, exec.signal);
+            }
+            else {
+                results = await clients.amap.poiSearch(args.keywords, { region: args.region, cityLimit: !!args.region }, exec.signal);
+            }
+            return {
+                count: results.length,
+                results: results.map((r) => ({
+                    name: r.name,
+                    location: r.location,
+                    type: r.type,
+                    address: r.address,
+                    tel: r.tel,
+                    distanceM: r.distanceM,
+                })),
+            };
+        },
+    })));
+}