@danceiny/gotry 0.0.1-rc.14 → 0.0.1-rc.16

package/dist/capabilities/artifacts.js

@@ -0,0 +1,217 @@
+import { readdir, readFile, stat } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { isAbsolute, join, resolve, sep } from 'node:path';
+import { openLedgerIfExists } from '../src/state-ledger.js';
+const MAX_LIST = 50;
+const MAX_WINDOW = 400;
+const MAX_BYTES = 2 * 1024 * 1024;
+const TEXT_EXT_LANG = {
+    md: 'markdown',
+    txt: 'text',
+    json: 'json',
+    jsonl: 'json',
+    csv: 'csv',
+    log: 'text',
+    yaml: 'yaml',
+    yml: 'yaml'
+};
+const DIR_DENY = [
+    'node_modules',
+    '.git'
+];
+function rootOf(stateRoot) {
+    return stateRoot === '.' ? process.cwd() : resolve(stateRoot);
+}
+function underRoot(p, root) {
+    const r = resolve(root);
+    return p === r || p.startsWith(r + sep);
+}
+function hasDeniedSegment(p) {
+    return p.split(sep).some((seg)=>DIR_DENY.includes(seg));
+}
+function asyncDeliverablePath(root, id) {
+    return join(root, 'gotry-state', 'async', `${id}.deliverable.md`);
+}
+function listRunsFromLedger(root, tenant, limit) {
+    const ledger = openLedgerIfExists(root, tenant);
+    if (!ledger) return [];
+    const rows = ledger.db.prepare('SELECT id, goal, status, deliverable, updated FROM workflow_runs WHERE tenant_id = ? ORDER BY updated DESC LIMIT ?').all(ledger.tenant, limit);
+    return rows.map((r)=>{
+        const file = asyncDeliverablePath(root, r.id);
+        return {
+            source: 'async-run',
+            id: r.id,
+            title: r.goal,
+            path: file,
+            status: r.status,
+            updated: r.updated,
+            bytes: r.deliverable?.length
+        };
+    });
+}
+async function listDeliverableFiles(root, limit) {
+    const dir = join(root, 'gotry-state', 'async');
+    let names = [];
+    try {
+        names = (await readdir(dir)).filter((n)=>n.endsWith('.deliverable.md'));
+    } catch  {
+        return [];
+    }
+    const entries = [];
+    for (const n of names.slice(0, limit * 2)){
+        const p = join(dir, n);
+        const st = await stat(p).catch(()=>null);
+        if (!st?.isFile()) continue;
+        entries.push({
+            source: 'async-run',
+            id: n.replace(/\.deliverable\.md$/, ''),
+            title: n.replace(/\.deliverable\.md$/, ''),
+            path: p,
+            status: existsSync(p.replace(/\.deliverable\.md$/, '.json')) ? 'pending-view' : 'legacy',
+            updated: new Date(st.mtimeMs).toISOString(),
+            bytes: st.size
+        });
+    }
+    return entries.sort((a, b)=>String(b.updated).localeCompare(String(a.updated)));
+}
+async function listCwdMarkdown(cwd, limit) {
+    let dirents;
+    try {
+        dirents = await readdir(cwd, {
+            withFileTypes: true
+        });
+    } catch  {
+        return [];
+    }
+    const entries = [];
+    for (const d of dirents){
+        if (!d.isFile() || !/\.md$/i.test(d.name) || d.name.startsWith('.')) continue;
+        const p = join(cwd, d.name);
+        const st = await stat(p).catch(()=>null);
+        if (!st) continue;
+        entries.push({
+            source: 'cwd-file',
+            id: d.name,
+            title: d.name.replace(/\.md$/i, ''),
+            path: p,
+            updated: new Date(st.mtimeMs).toISOString(),
+            bytes: st.size
+        });
+    }
+    return entries.sort((a, b)=>String(b.updated).localeCompare(String(a.updated))).slice(0, limit);
+}
+export async function listArtifacts(opts) {
+    const limit = Math.max(1, Math.min(opts.limit ?? 20, MAX_LIST));
+    const root = rootOf(opts.stateRoot);
+    const cwd = opts.cwd ? resolve(opts.cwd) : process.cwd();
+    const seenPath = new Set();
+    const merged = [];
+    for (const e of [
+        ...listRunsFromLedger(root, 'local', limit),
+        ...await listDeliverableFiles(root, limit),
+        ...await listCwdMarkdown(cwd, limit)
+    ]){
+        if (seenPath.has(e.path)) continue;
+        seenPath.add(e.path);
+        merged.push(e);
+    }
+    merged.sort((a, b)=>String(b.updated ?? '').localeCompare(String(a.updated ?? '')));
+    const total = merged.length;
+    return {
+        artifacts: merged.slice(0, limit),
+        total,
+        truncated: total > limit,
+        roots: [
+            root,
+            cwd
+        ]
+    };
+}
+export async function readArtifact(opts) {
+    const root = rootOf(opts.stateRoot);
+    const cwd = opts.cwd ? resolve(opts.cwd) : process.cwd();
+    const raw = String(opts.path ?? '').trim();
+    if (!raw) return {
+        ok: false,
+        error: 'path 必填(来自 gotry_artifacts_list 的 path,或异步工单 id)'
+    };
+    let text = null;
+    let filePath = '';
+    if (!raw.includes('/') && !raw.includes('\\') && !raw.includes('.')) {
+        const ledger = openLedgerIfExists(root, 'local');
+        const run = ledger?.db.prepare('SELECT id, goal, status, deliverable FROM workflow_runs WHERE id = ? AND tenant_id = ?').get(raw, ledger.tenant);
+        if (run?.deliverable) {
+            text = run.deliverable;
+            filePath = asyncDeliverablePath(root, raw);
+        } else {
+            const p = asyncDeliverablePath(root, raw);
+            if (existsSync(p)) {
+                filePath = p;
+                text = await readFile(p, 'utf-8');
+            }
+        }
+        if (text === null) return {
+            ok: false,
+            error: `工单 ${raw} 无 deliverable(未交付或不存在)`,
+            hint: '先 gotry_artifacts_list 看在册产物'
+        };
+    }
+    if (text === null) {
+        const candidates = isAbsolute(raw) ? [
+            resolve(raw)
+        ] : [
+            resolve(cwd, raw),
+            resolve(root, raw),
+            resolve(root, 'gotry-state', 'async', raw)
+        ];
+        const allowed = candidates.find((p)=>(underRoot(p, cwd) || underRoot(p, root)) && !hasDeniedSegment(p));
+        if (!allowed) {
+            return {
+                ok: false,
+                error: `路径越界:${raw}`,
+                hint: `只读 ${root} 与 dsh 工作目录内的文本产物`
+            };
+        }
+        const ext = allowed.slice(allowed.lastIndexOf('.') + 1).toLowerCase();
+        if (!TEXT_EXT_LANG[ext]) {
+            return {
+                ok: false,
+                error: `不支持的文件类型 .${ext}`,
+                hint: `白名单:${Object.keys(TEXT_EXT_LANG).join('/')}`
+            };
+        }
+        const st = await stat(allowed).catch(()=>null);
+        if (!st?.isFile()) return {
+            ok: false,
+            error: `文件不存在:${raw}`,
+            hint: '先 gotry_artifacts_list 看在册产物'
+        };
+        if (st.size > MAX_BYTES) return {
+            ok: false,
+            error: `文件过大(${st.size} bytes > ${MAX_BYTES})`
+        };
+        filePath = allowed;
+        text = await readFile(allowed, 'utf-8');
+    }
+    const allLines = text.split('\n');
+    const offset = Math.max(1, Math.min(opts.offset ?? 1, allLines.length));
+    const limit = Math.max(1, Math.min(opts.limit ?? MAX_WINDOW, MAX_WINDOW));
+    const slice = allLines.slice(offset - 1, offset - 1 + limit);
+    const ext = filePath.slice(filePath.lastIndexOf('.') + 1).toLowerCase();
+    return {
+        ok: true,
+        path: filePath,
+        offset,
+        lines: slice.map((t, i)=>({
+                number: offset + i,
+                text: t
+            })),
+        totalLines: allLines.length,
+        lang: TEXT_EXT_LANG[ext] ?? 'text',
+        content: slice.join('\n'),
+        windowed: allLines.length > offset - 1 + slice.length
+    };
+}
+
+
+//# sourceURL=/Users/bytedance/work/gotry-publish/ts/capabilities/artifacts.ts

package/dist/capabilities/effect.js

@@ -0,0 +1,293 @@
+import { CircuitBreaker, withRetry } from './resilience.js';
+import { flyaiSearch } from './flyai.js';
+import { checkAvail, hotelRates, searchHotels } from './hbcli.js';
+import { sessionFlightSearch } from './session-search.js';
+import { geocodePlace, getClimate, getForecast } from './weather.js';
+import { verifyFlight } from './opensky.js';
+const DEFAULT_HANDLERS = {
+    FLYAI_SEARCH: (p)=>flyaiSearch(p),
+    HBCLI_HOTEL_SEARCH: (p)=>searchHotels({
+            destination: p.destination,
+            checkIn: p.checkIn,
+            checkOut: p.checkOut,
+            adults: p.adults
+        }, {
+            hbcliBin: p.hbcliBin,
+            timeoutMs: p.timeoutMs,
+            fallbackPath: p.fallbackPath
+        }),
+    HBCLI_HOTEL_RATES: (p)=>hotelRates({
+            hotelId: p.hotelId,
+            checkIn: p.checkIn,
+            checkOut: p.checkOut,
+            adults: p.adults,
+            countryCode: p.countryCode,
+            nationalityCode: p.nationalityCode,
+            residencyCode: p.residencyCode
+        }, {
+            hbcliBin: p.hbcliBin,
+            timeoutMs: p.timeoutMs
+        }),
+    HBCLI_CHECK_AVAIL: (p)=>checkAvail({
+            ratePkgId: p.ratePkgId
+        }, {
+            hbcliBin: p.hbcliBin,
+            timeoutMs: p.timeoutMs
+        }),
+    SESSION_FLIGHT_SEARCH: (p)=>sessionFlightSearch(p),
+    WEATHER_GEOCODE: (p)=>geocodePlace(p.name, {
+            count: p.count,
+            timeoutMs: p.timeoutMs
+        }),
+    WEATHER_FORECAST: (p)=>getForecast({
+            latitude: p.latitude,
+            longitude: p.longitude
+        }, {
+            days: p.days,
+            timeoutMs: p.timeoutMs
+        }),
+    WEATHER_CLIMATE: (p)=>getClimate({
+            latitude: p.latitude,
+            longitude: p.longitude
+        }, p.month, {
+            timeoutMs: p.timeoutMs
+        }),
+    OPENSKY_FLIGHT_VERIFY: (p)=>verifyFlight(p)
+};
+const defaultIsFailure = (r)=>r?.ok === false;
+const flyaiTransient = (msg)=>msg.length > 0 && !/Sentinel/i.test(msg) && /timeout|timed out|ECONNRESET|ECONNREFUSED|ETIMEDOUT|socket|HTTP 5/i.test(msg);
+const API_RETRY = {
+    maxAttempts: 2,
+    baseDelayMs: 400,
+    maxDelayMs: 1_600
+};
+const API_BREAKER = {
+    failureThreshold: 3,
+    openMs: 30_000
+};
+const SPECS = {
+    FLYAI_SEARCH: {
+        channel: 'cli',
+        retry: {
+            maxAttempts: 2,
+            baseDelayMs: 500,
+            maxDelayMs: 2_000
+        },
+        breaker: {
+            failureThreshold: 3,
+            openMs: 60_000
+        },
+        isRetryable: (_r, e)=>{
+            const msg = e != null ? String(e.message ?? e) : String((_r ?? {}).error ?? '');
+            return flyaiTransient(msg);
+        },
+        isFailure: defaultIsFailure
+    },
+    HBCLI_HOTEL_SEARCH: {
+        channel: 'cli',
+        retry: null,
+        breaker: {
+            failureThreshold: 3,
+            openMs: 60_000
+        },
+        isFailure: (r)=>r.via === 'hbcli-error'
+    },
+    HBCLI_HOTEL_RATES: {
+        channel: 'cli',
+        retry: null,
+        breaker: {
+            failureThreshold: 3,
+            openMs: 60_000
+        },
+        isFailure: (r)=>r.via === 'hbcli-error'
+    },
+    HBCLI_CHECK_AVAIL: {
+        channel: 'cli',
+        retry: null,
+        breaker: {
+            failureThreshold: 3,
+            openMs: 60_000
+        },
+        isFailure: (r)=>r.via === 'hbcli-error'
+    },
+    SESSION_FLIGHT_SEARCH: {
+        channel: 'browser',
+        retry: null,
+        breaker: null,
+        isFailure: defaultIsFailure
+    },
+    WEATHER_GEOCODE: {
+        channel: 'api',
+        retry: API_RETRY,
+        breaker: API_BREAKER,
+        isFailure: defaultIsFailure
+    },
+    WEATHER_FORECAST: {
+        channel: 'api',
+        retry: API_RETRY,
+        breaker: API_BREAKER,
+        isFailure: defaultIsFailure
+    },
+    WEATHER_CLIMATE: {
+        channel: 'api',
+        retry: API_RETRY,
+        breaker: API_BREAKER,
+        isFailure: defaultIsFailure
+    },
+    OPENSKY_FLIGHT_VERIFY: {
+        channel: 'api',
+        retry: API_RETRY,
+        breaker: API_BREAKER,
+        isRetryable: (_r, e)=>e != null || (_r ?? {}).verdict === 'unavailable',
+        isFailure: (r)=>r.via === 'opensky-error'
+    }
+};
+export function declinedObservation(effect, trace) {
+    return {
+        ok: false,
+        verdict: 'error',
+        summary: trace.declined === 'circuit-open' ? `${effect} 通道被断路器开启保护(连续失败达到阈值,冷却中)——不要立即重试,换其他工具或稍后再试;原因见 trace 证据链` : `${effect} 未登记效应(effect_interpreter.v1 注册表外,生产解译器拒绝)`,
+        evidence: trace.evidence.join(';')
+    };
+}
+const defaultBreakers = new Map();
+const defaultSleep = (ms)=>new Promise((resolve)=>setTimeout(resolve, ms));
+export function __resetEffectBreakersForTest() {
+    defaultBreakers.clear();
+}
+export function makeProductionInterpreter(opts = {}) {
+    const breakers = opts.breakers ?? defaultBreakers;
+    const sleep = opts.sleep ?? defaultSleep;
+    return async (fx)=>{
+        const ts = new Date().toISOString();
+        const name = fx.effect;
+        const spec = SPECS[name];
+        const handler = opts.handlers?.[fx.effect] ?? DEFAULT_HANDLERS[name];
+        if (!spec || !handler) {
+            return {
+                result: null,
+                trace: {
+                    effect: fx.effect,
+                    channel: 'api',
+                    attempts: 0,
+                    backoffMs: 0,
+                    breaker: 'off',
+                    declined: 'unknown-effect',
+                    evidence: [
+                        `[效应:${fx.effect}@${ts}] unknown effect`
+                    ]
+                }
+            };
+        }
+        const br = (()=>{
+            if (!spec.breaker) return null;
+            const existing = breakers.get(fx.effect);
+            if (existing) return existing;
+            const created = new CircuitBreaker({
+                ...spec.breaker,
+                ...opts.now ? {
+                    now: opts.now
+                } : {}
+            });
+            breakers.set(fx.effect, created);
+            return created;
+        })();
+        const gate = br?.canAttempt() ?? {
+            allowed: true,
+            state: 'closed'
+        };
+        if (!gate.allowed) {
+            const trace = {
+                effect: fx.effect,
+                channel: spec.channel,
+                attempts: 0,
+                backoffMs: 0,
+                breaker: gate.state,
+                declined: 'circuit-open',
+                evidence: [
+                    `[效应:${fx.effect}@${ts}] breaker=${gate.state} 拒绝(冷却中,不重试)`
+                ]
+            };
+            return {
+                result: null,
+                trace
+            };
+        }
+        const policy = spec.retry ? {
+            maxAttempts: spec.retry.maxAttempts,
+            baseDelayMs: spec.retry.baseDelayMs,
+            maxDelayMs: spec.retry.maxDelayMs,
+            isRetryable: spec.isRetryable,
+            sleep
+        } : {
+            maxAttempts: 1,
+            baseDelayMs: 0,
+            maxDelayMs: 0,
+            sleep
+        };
+        const dispatch = handler;
+        const outcome = await withRetry(()=>dispatch(fx.params), policy);
+        const failed = outcome.error != null || spec.isFailure(outcome.result);
+        if (br) failed ? br.onFailure() : br.onSuccess();
+        const breakerState = br?.state() ?? 'off';
+        const evidence = [
+            `[效应:${fx.effect}@${ts}] attempts=${outcome.attempts} backoff=${outcome.backoffMs}ms breaker=${breakerState}`
+        ];
+        return {
+            result: outcome.error != null ? null : outcome.result,
+            trace: {
+                effect: fx.effect,
+                channel: spec.channel,
+                attempts: outcome.attempts,
+                backoffMs: outcome.backoffMs,
+                breaker: breakerState,
+                evidence
+            }
+        };
+    };
+}
+export const productionInterpreter = makeProductionInterpreter();
+export async function interpretEffect(fx) {
+    return productionInterpreter(fx);
+}
+export function makeMockInterpreter(fixtures) {
+    return async (fx)=>{
+        const ts = new Date().toISOString();
+        const registered = Object.prototype.hasOwnProperty.call(fixtures, fx.effect);
+        if (!registered) {
+            return {
+                result: null,
+                trace: {
+                    effect: fx.effect,
+                    channel: 'mock',
+                    attempts: 0,
+                    backoffMs: 0,
+                    breaker: 'off',
+                    declined: 'unknown-effect',
+                    evidence: [
+                        `[效应:mock@${ts}] ${fx.effect} 未登记夹具`
+                    ]
+                }
+            };
+        }
+        return {
+            result: fixtures[fx.effect],
+            trace: {
+                effect: fx.effect,
+                channel: 'mock',
+                attempts: 1,
+                backoffMs: 0,
+                breaker: 'off',
+                evidence: [
+                    `[效应:mock@${ts}] ${fx.effect} 夹具回放(确定性,无网络)`
+                ]
+            }
+        };
+    };
+}
+export function selectInterpreter(env, opts = {}) {
+    return env === 'mock' ? makeMockInterpreter(opts.fixtures ?? {}) : makeProductionInterpreter(opts);
+}
+
+
+//# sourceURL=/Users/bytedance/work/gotry-publish/ts/capabilities/effect.ts

package/dist/capabilities/fact-log.js

@@ -0,0 +1,41 @@
+import { appendFile, mkdir, readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { dedupeFacts } from '../src/bookable-facts.js';
+export const FACT_LOG_NAME = 'bookable-facts.jsonl';
+export function factLogPath(stateRoot) {
+    const root = stateRoot === '.' ? process.cwd() : stateRoot;
+    return join(root, 'gotry-state', FACT_LOG_NAME);
+}
+export async function appendFacts(stateRoot, facts) {
+    if (facts.length === 0) return true;
+    try {
+        const p = factLogPath(stateRoot);
+        await mkdir(join(p, '..'), {
+            recursive: true
+        });
+        await appendFile(p, facts.map((f)=>JSON.stringify(f)).join('\n') + '\n', 'utf-8');
+        return true;
+    } catch  {
+        return false;
+    }
+}
+export async function loadFactRegistry(stateRoot) {
+    try {
+        const raw = await readFile(factLogPath(stateRoot), 'utf-8');
+        const facts = [];
+        for (const line of raw.split('\n')){
+            const t = line.trim();
+            if (!t) continue;
+            try {
+                const f = JSON.parse(t);
+                if (f.schema === 'gotry_bookable_fact.v1' && f.fact_id) facts.push(f);
+            } catch  {}
+        }
+        return dedupeFacts(facts);
+    } catch  {
+        return [];
+    }
+}
+
+
+//# sourceURL=/Users/bytedance/work/gotry-publish/ts/capabilities/fact-log.ts

package/dist/capabilities/flyai.js

@@ -233,4 +233,4 @@ function parseHotelItems(items) {
 }
 
 
-//# sourceURL=/Users/bytedance/work/gotry/ts/capabilities/flyai.ts
+//# sourceURL=/Users/bytedance/work/gotry-publish/ts/capabilities/flyai.ts

package/dist/capabilities/hbcli.js

@@ -177,6 +177,48 @@ export async function listDestinations(opts = {}) {
         destinations: r.result
     };
 }
+export async function hotelRates(query, opts = {}) {
+    const hbArgs = [
+        'search',
+        'hotel-rates',
+        '--json',
+        '--hotel-id',
+        query.hotelId
+    ];
+    if (query.checkIn) hbArgs.push('--check-in', query.checkIn);
+    if (query.checkOut) hbArgs.push('--check-out', query.checkOut);
+    if (query.countryCode) hbArgs.push('--country-code', query.countryCode);
+    if (query.nationalityCode) hbArgs.push('--nationality-code', query.nationalityCode);
+    if (query.residencyCode) hbArgs.push('--residency-code', query.residencyCode);
+    if (query.adults) hbArgs.push('--room-occupancies', JSON.stringify([
+        {
+            adultCount: query.adults,
+            childrenAges: []
+        }
+    ]));
+    const live = await callHbcliJson(hbArgs, opts);
+    const summary = live.via === 'hbcli-realtime' ? `hotel ${query.hotelId}:hbcli 实时报价${query.checkIn ? `(${query.checkIn} → ${query.checkOut ?? '?'})` : ''}` : `hotel ${query.hotelId}:hbcli 实时报价不可用(${live.error ?? live.via});价格面无静态降级,fail-closed 不估算`;
+    return {
+        ...live,
+        rates: live.result,
+        summary
+    };
+}
+export async function checkAvail(query, opts = {}) {
+    const live = await callHbcliJson([
+        'search',
+        'check-avail',
+        '--json',
+        '--rate-pkg-id',
+        query.ratePkgId
+    ], opts);
+    const summary = live.via === 'hbcli-realtime' ? `ratePkg ${query.ratePkgId}:hbcli 实时验价(库存与价格以后端为准)` : `ratePkg ${query.ratePkgId}:hbcli 实时验价不可用(${live.error ?? live.via});价格面无静态降级,fail-closed`;
+    return {
+        ...live,
+        avail: live.result,
+        summary
+    };
+}
 
 
-//# sourceURL=/Users/bytedance/work/gotry/ts/capabilities/hbcli.ts
+//# sourceURL=/Users/bytedance/work/gotry-publish/ts/capabilities/hbcli.ts

package/dist/capabilities/incident-log.js

@@ -97,4 +97,4 @@ if (import.meta.url === `file://${fileURLToPath(import.meta.url)}` && process.ar
 }
 
 
-//# sourceURL=/Users/bytedance/work/gotry/ts/capabilities/incident-log.ts
+//# sourceURL=/Users/bytedance/work/gotry-publish/ts/capabilities/incident-log.ts

package/dist/capabilities/opensky.js

@@ -71,4 +71,4 @@ export async function verifyFlight(query) {
 }
 
 
-//# sourceURL=/Users/bytedance/work/gotry/ts/capabilities/opensky.ts
+//# sourceURL=/Users/bytedance/work/gotry-publish/ts/capabilities/opensky.ts