@deepexi/datasense-connector 3.0.1 → 3.1.0

package/index.d.ts

@@ -1,13 +0,0 @@
-export type { ArrayType, CheckContext, CheckpointItem, ConnectorCache, ConnectorCrypto, ConnectorDb, ConnectorDefinition, ConnectorLog, ConnectorRateLimit, ConnectorSignal, ConnectorTime, CursorPaginateOptions, DigestEncoding, DiscoverContext, DiscoverResult, FieldMeta, HashAlgorithm, HmacAlgorithm, HttpAuth, HttpClient, HttpMethod, HttpOptions, HttpResponse, KeysetPaginateOptions, LinkPaginateOptions, ObjectType, OffsetPaginateOptions, Page, PagePaginateOptions, Paginate, PullContext, PushContext, PushDiscovery, PushHandler, PushRequest, RecordItem, RemoveItem, ScalarKind, ScalarType, SdkType, SecretType, SignAlgorithm, StreamDiscovery, StreamFunction, StreamInput, StreamItem, SyncMode, TableDeclaration, } from './types.js';
-export { defineConnector } from './types.js';
-export { t } from './t.js';
-export type { RateLimitedError } from './errors.js';
-export { ConnectorError, errors } from './errors.js';
-export type { DeclarationIssue, DefinitionSummary, NormalizedDiscoverResult } from './validate.js';
-export { DEFAULT_PUSH_NAME, normalizeDiscoverResult, PRESENTATION_LIMITS, RESERVED_PUSH_NAMES, SDK_NAME_PATTERN, summarizeDefinition, validateConfig, validateConnectorDefinition, validateDiscoverResult, } from './validate.js';
-export type { ConnectorIconPath, ConnectorPresentation, Sha256Hex } from './presentation.js';
-export { decodeConnectorIcon, PNG_DATA_URI_PREFIX, readConnectorPresentation } from './presentation.js';
-/** SDK 版本，等于本包 `package.json` 的 `version`；meta 打包校验 `dependencies` 范围与 runner 都用它。 */
-export declare const SDK_VERSION: string;
-/** runner 支持的 SDK 主版本集合；连接器 `dependencies` 里 SDK 的下限主版本必须在其中。 */
-export declare const SUPPORTED_SDK_MAJORS: readonly number[];

package/index.js

@@ -1,7 +0,0 @@
-export { defineConnector } from './types.js';
-export { t } from './t.js';
-export { ConnectorError, errors } from './errors.js';
-export { DEFAULT_PUSH_NAME, normalizeDiscoverResult, PRESENTATION_LIMITS, RESERVED_PUSH_NAMES, SDK_NAME_PATTERN, summarizeDefinition, validateConfig, validateConnectorDefinition, validateDiscoverResult, } from './validate.js';
-export { decodeConnectorIcon, PNG_DATA_URI_PREFIX, readConnectorPresentation } from './presentation.js';
-export const SDK_VERSION = '3.0.1';
-export const SUPPORTED_SDK_MAJORS = [3];

package/internal/location.d.ts

@@ -1,6 +0,0 @@
-/** 当前是否直接从源码（`.ts`）执行。 */
-export declare const IS_SOURCE: boolean;
-/** `src/`（源码）或 `dist/`（构建产物）。 */
-export declare const PACKAGE_ROOT: string;
-/** 源码与 dist 下同一模块的路径：`relative` 不带扩展名，源码取 `.ts`，dist 取 `.js`。 */
-export declare function moduleFile(relative: string): string;

package/internal/location.js

@@ -1,8 +0,0 @@
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-const self = fileURLToPath(import.meta.url);
-export const IS_SOURCE = self.endsWith('.ts');
-export const PACKAGE_ROOT = path.resolve(path.dirname(self), '..');
-export function moduleFile(relative) {
-    return path.join(PACKAGE_ROOT, `${relative}${IS_SOURCE ? '.ts' : '.js'}`);
-}

package/presentation.d.ts

@@ -1,38 +0,0 @@
-/**
- * 连接器清单的展示元数据：`package.json` 的 `description`、`ontos.title`、`ontos.icon` 与根目录 `README.md`。
- * CLI（`connector validate` / `publish`）与 meta（写草稿、在线编辑器保存）共用这一个校验函数，结果确定、不抛异常。
- *
- * 源码 `files` 是 UTF-8 文本映射：`icon.svg` 存原文，`icon.png` 存 `data:image/png;base64,<…>`。
- * 图标是租户上传的不可信内容，不合规的 SVG 直接拒绝、不做清洗（界面只用 `<img>` 渲染）。
- * 本文件只用 `TextEncoder` 与 `atob`，不引用 Node / Bun 内置模块；sha256 由调用方传入。
- */
-import { type DeclarationIssue } from './validate.js';
-export type ConnectorIconPath = 'icon.svg' | 'icon.png';
-export interface ConnectorPresentation {
-    title: string | null;
-    description: string | null;
-    icon: {
-        path: ConnectorIconPath;
-        mime: 'image/svg+xml' | 'image/png';
-        sha256: string;
-        bytes: number;
-    } | null;
-    readme: boolean;
-}
-/** 字节的 sha256，小写十六进制。CLI 与 meta 用 `node:crypto` 实现。 */
-export type Sha256Hex = (bytes: Uint8Array) => string;
-/** `icon.png` 在源码映射里的前缀。 */
-export declare const PNG_DATA_URI_PREFIX = "data:image/png;base64,";
-/** SVG 图标的问题（文字不带路径）；合法时 null。按小写文本扫描，不做 DOM 解析。 */
-export declare function svgIconProblem(text: string): string | null;
-/**
- * 读 `package.json` 与 `files` 里的展示元数据。展示元数据都可选；`package.json` 缺失或不是 JSON 对象时报 `package.json` 问题。
- * 问题路径：`package.json:description`、`package.json:ontos`、`package.json:ontos.title`、`package.json:ontos.icon`、
- * 图标文件路径（`icon.svg` / `icon.png`）与 `README.md`。有问题的项在 presentation 里为 null / false。
- */
-export declare function readConnectorPresentation(files: Record<string, string>, sha256: Sha256Hex): {
-    presentation: ConnectorPresentation;
-    issues: DeclarationIssue[];
-};
-/** 解码图标为字节；文件不存在或不合规返回 null。 */
-export declare function decodeConnectorIcon(files: Record<string, string>, path: ConnectorIconPath): Uint8Array | null;

package/presentation.js

@@ -1,268 +0,0 @@
-import { PRESENTATION_LIMITS } from './validate.js';
-const PACKAGE_JSON = 'package.json';
-const README = 'README.md';
-const ICON_PATHS = ['icon.svg', 'icon.png'];
-const ICON_MIME = { 'icon.svg': 'image/svg+xml', 'icon.png': 'image/png' };
-export const PNG_DATA_URI_PREFIX = 'data:image/png;base64,';
-const PNG_SIGNATURE = [0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a];
-const BASE64 = /^[A-Za-z0-9+/]*={0,2}$/;
-const FORBIDDEN_SVG_ELEMENTS = new Set(['script', 'foreignobject', 'iframe', 'object', 'embed']);
-const ALLOWED_ENTITIES = new Set(['amp', 'lt', 'gt', 'quot', 'apos']);
-const EMPTY_PRESENTATION = { title: null, description: null, icon: null, readme: false };
-function isRecord(value) {
-    return typeof value === 'object' && value !== null && !Array.isArray(value);
-}
-function charCount(text) {
-    return [...text].length;
-}
-function utf8Length(text) {
-    return new TextEncoder().encode(text).length;
-}
-function readText(owner, key, path, max, issues) {
-    const value = owner[key];
-    if (value === undefined)
-        return null;
-    if (typeof value !== 'string' || value.trim().length === 0) {
-        issues.push({ path, message: `${path.slice(PACKAGE_JSON.length + 1)} must be a non-empty string` });
-        return null;
-    }
-    if (charCount(value) > max) {
-        issues.push({ path, message: `${path.slice(PACKAGE_JSON.length + 1)} must be at most ${max} characters` });
-        return null;
-    }
-    return value;
-}
-function scanSvgTags(text) {
-    const tags = [];
-    let i = 0;
-    const n = text.length;
-    const isSpace = (ch) => ch === ' ' || ch === '\t' || ch === '\n' || ch === '\r';
-    while (i < n) {
-        const lt = text.indexOf('<', i);
-        if (lt === -1)
-            break;
-        if (text.startsWith('<!--', lt)) {
-            const end = text.indexOf('-->', lt + 4);
-            if (end === -1)
-                return null;
-            i = end + 3;
-            continue;
-        }
-        if (text.startsWith('<?', lt)) {
-            const end = text.indexOf('?>', lt + 2);
-            if (end === -1)
-                return null;
-            i = end + 2;
-            continue;
-        }
-        i = lt + 1;
-        if (text[i] === '/') {
-            const end = text.indexOf('>', i);
-            if (end === -1)
-                return null;
-            i = end + 1;
-            continue;
-        }
-        while (isSpace(text[i]))
-            i += 1;
-        let name = '';
-        while (i < n && !isSpace(text[i]) && text[i] !== '>' && text[i] !== '/')
-            name += text[i++];
-        const tag = { name: name.slice(name.lastIndexOf(':') + 1), attributes: [] };
-        for (;;) {
-            while (isSpace(text[i]))
-                i += 1;
-            if (i >= n)
-                return null;
-            if (text[i] === '>') {
-                i += 1;
-                break;
-            }
-            if (text[i] === '/') {
-                i += 1;
-                continue;
-            }
-            let attr = '';
-            while (i < n && !isSpace(text[i]) && text[i] !== '=' && text[i] !== '>' && text[i] !== '/')
-                attr += text[i++];
-            while (isSpace(text[i]))
-                i += 1;
-            let value = '';
-            if (text[i] === '=') {
-                i += 1;
-                while (isSpace(text[i]))
-                    i += 1;
-                const quote = text[i];
-                if (quote === '"' || quote === "'") {
-                    const end = text.indexOf(quote, i + 1);
-                    if (end === -1)
-                        return null;
-                    value = text.slice(i + 1, end);
-                    i = end + 1;
-                }
-                else {
-                    while (i < n && !isSpace(text[i]) && text[i] !== '>')
-                        value += text[i++];
-                }
-            }
-            if (attr)
-                tag.attributes.push({ name: attr, value });
-        }
-        tags.push(tag);
-    }
-    return tags;
-}
-function cssProblem(css) {
-    const lower = css.toLowerCase();
-    if (lower.includes('url(') || lower.includes('@import'))
-        return 'must not reference url() or @import in styles';
-    if (css.includes('\\'))
-        return 'must not use escapes in styles';
-    return null;
-}
-export function svgIconProblem(text) {
-    const lower = text.toLowerCase();
-    if (lower.includes('<!doctype') || lower.includes('<!entity'))
-        return 'icon.svg must not contain <!DOCTYPE> or <!ENTITY>';
-    if (lower.includes('<![cdata['))
-        return 'icon.svg must not contain CDATA sections';
-    for (const match of lower.matchAll(/&(#?[a-z0-9]*);?/g)) {
-        if (!ALLOWED_ENTITIES.has(match[1] ?? '') || !match[0].endsWith(';'))
-            return 'icon.svg must not contain character or entity references other than &amp; &lt; &gt; &quot; &apos;';
-    }
-    const tags = scanSvgTags(lower);
-    if (tags === null)
-        return 'icon.svg is not well-formed XML';
-    const root = tags[0];
-    if (!root || root.name !== 'svg')
-        return 'icon.svg must have an <svg> root element';
-    if (!root.attributes.some((attribute) => attribute.name === 'viewbox'))
-        return 'icon.svg root element must have a viewBox';
-    for (const tag of tags) {
-        if (FORBIDDEN_SVG_ELEMENTS.has(tag.name))
-            return `icon.svg must not contain <${tag.name}>`;
-        for (const { name, value } of tag.attributes) {
-            const local = name.slice(name.lastIndexOf(':') + 1);
-            if (local.startsWith('on'))
-                return `icon.svg must not contain event handler attributes (${name})`;
-            if (local === 'href' && !value.trim().startsWith('#'))
-                return `icon.svg ${name} must be a local reference starting with #`;
-            if (local === 'style') {
-                const problem = cssProblem(value);
-                if (problem)
-                    return `icon.svg style attribute ${problem}`;
-            }
-        }
-    }
-    for (const match of lower.matchAll(/<(?:[a-z0-9_.-]+:)?style\b[^>]*>([\s\S]*?)(?:<\/|$)/g)) {
-        const problem = cssProblem(match[1] ?? '');
-        if (problem)
-            return `icon.svg <style> ${problem}`;
-    }
-    return null;
-}
-function decodeBase64(text) {
-    if (text.length % 4 !== 0 || !BASE64.test(text))
-        return null;
-    try {
-        const binary = atob(text);
-        const bytes = new Uint8Array(binary.length);
-        for (let i = 0; i < binary.length; i += 1)
-            bytes[i] = binary.charCodeAt(i);
-        return bytes;
-    }
-    catch {
-        return null;
-    }
-}
-function readUint32(bytes, offset) {
-    return ((bytes[offset] ?? 0) * 0x1000000) + (((bytes[offset + 1] ?? 0) << 16) | ((bytes[offset + 2] ?? 0) << 8) | (bytes[offset + 3] ?? 0));
-}
-function checkIcon(path, content) {
-    const limit = PRESENTATION_LIMITS.iconBytes;
-    if (path === 'icon.svg') {
-        const bytes = new TextEncoder().encode(content);
-        if (bytes.length > limit)
-            return { problem: `icon.svg must be at most ${limit} bytes` };
-        const problem = svgIconProblem(content);
-        return problem ? { problem } : { bytes };
-    }
-    if (!content.startsWith(PNG_DATA_URI_PREFIX))
-        return { problem: `icon.png must be stored as ${PNG_DATA_URI_PREFIX}<data>` };
-    const encoded = content.slice(PNG_DATA_URI_PREFIX.length);
-    if (Math.floor(encoded.length / 4) * 3 - 2 > limit)
-        return { problem: `icon.png must be at most ${limit} bytes` };
-    const bytes = decodeBase64(encoded);
-    if (bytes === null)
-        return { problem: 'icon.png is not valid base64' };
-    if (bytes.length > limit)
-        return { problem: `icon.png must be at most ${limit} bytes` };
-    if (bytes.length < 24 || PNG_SIGNATURE.some((byte, i) => bytes[i] !== byte) || String.fromCharCode(...bytes.subarray(12, 16)) !== 'IHDR') {
-        return { problem: 'icon.png is not a PNG image' };
-    }
-    const width = readUint32(bytes, 16);
-    const height = readUint32(bytes, 20);
-    const min = PRESENTATION_LIMITS.iconMinPx;
-    if (width !== height || width < min)
-        return { problem: `icon.png must be square and at least ${min}×${min} pixels, got ${width}×${height}` };
-    return { bytes };
-}
-export function readConnectorPresentation(files, sha256) {
-    const issues = [];
-    let pkg;
-    try {
-        pkg = JSON.parse(files[PACKAGE_JSON] ?? '');
-    }
-    catch {
-        pkg = undefined;
-    }
-    if (!isRecord(pkg)) {
-        return { presentation: { ...EMPTY_PRESENTATION }, issues: [{ path: PACKAGE_JSON, message: 'package.json must be a JSON object' }] };
-    }
-    const presentation = { ...EMPTY_PRESENTATION };
-    presentation.description = readText(pkg, 'description', `${PACKAGE_JSON}:description`, PRESENTATION_LIMITS.description, issues);
-    const ontos = pkg.ontos;
-    if (ontos !== undefined && !isRecord(ontos)) {
-        issues.push({ path: `${PACKAGE_JSON}:ontos`, message: 'ontos must be an object' });
-    }
-    else if (ontos) {
-        presentation.title = readText(ontos, 'title', `${PACKAGE_JSON}:ontos.title`, PRESENTATION_LIMITS.title, issues);
-        const icon = ontos.icon;
-        if (icon !== undefined) {
-            if (typeof icon !== 'string' || !ICON_PATHS.includes(icon)) {
-                issues.push({ path: `${PACKAGE_JSON}:ontos.icon`, message: 'ontos.icon must be icon.svg or icon.png (a file in the source root)' });
-            }
-            else {
-                const path = icon;
-                const content = files[path];
-                if (content === undefined) {
-                    issues.push({ path, message: `${path} is referenced by ontos.icon but missing` });
-                }
-                else {
-                    const checked = checkIcon(path, content);
-                    if ('problem' in checked)
-                        issues.push({ path, message: checked.problem });
-                    else
-                        presentation.icon = { path, mime: ICON_MIME[path], sha256: sha256(checked.bytes), bytes: checked.bytes.length };
-                }
-            }
-        }
-    }
-    const readme = files[README];
-    if (readme !== undefined) {
-        if (utf8Length(readme) > PRESENTATION_LIMITS.readmeBytes) {
-            issues.push({ path: README, message: `README.md must be at most ${PRESENTATION_LIMITS.readmeBytes} bytes` });
-        }
-        else {
-            presentation.readme = true;
-        }
-    }
-    return { presentation, issues };
-}
-export function decodeConnectorIcon(files, path) {
-    const content = files[path];
-    if (content === undefined || !ICON_PATHS.includes(path))
-        return null;
-    const checked = checkIcon(path, content);
-    return 'bytes' in checked ? checked.bytes : null;
-}

package/runtime/guest/bridge.d.ts

@@ -1,53 +0,0 @@
-/**
- * guest 与宿主之间的唯一通道（在 vm 上下文**里**执行）。
- *
- * 宿主只调用 guest 交出的三个函数，参数与返回值只有字符串和上下文自己的值：
- * - `handle(json)`：父进程的 `reply` / `cancel`；
- * - `poll()`：取走待发的消息（`call` / `result` / `failure`），同时触发到期的定时器，返回 JSON 字符串；
- * - `start(json, factory)`：见 `index.ts`。
- * 宿主不往上下文里放任何函数或对象（宿主值的 `constructor` 链能拿到宿主的 `Function`），也不 `await`
- * 上下文里的 Promise。上下文里没有 `setTimeout`，`sleep` 由宿主按 `poll()` 回报的 `wake` 定时再调 `poll()` 实现。
- *
- * 用到的内置函数在本模块求值时取引用：guest 打包产物先于连接器代码执行，连接器之后改写全局不影响这里。
- */
-import { ConnectorError } from '../../errors.js';
-import type { HostMethod } from '../protocol.js';
-declare const jsonParse: (text: string, reviver?: (this: any, key: string, value: any) => any) => any;
-declare const jsonStringify: {
-    (value: any, replacer?: (this: any, key: string, value: any) => any, space?: string | number): string;
-    (value: any, replacer?: (number | string)[] | null, space?: string | number): string;
-};
-export { jsonParse, jsonStringify };
-/** 宿主调用失败：`code` 来自宿主（如 `EGRESS_RATE_LIMITED`），连接器按 `code` 判断。 */
-export declare class HostCallFailure extends ConnectorError {
-    readonly status: number | undefined;
-    readonly retryAfterMs: number | undefined;
-    constructor(code: string, message: string, status?: number, retryAfterMs?: number);
-}
-/** 运行被取消。 */
-export declare class CanceledError extends ConnectorError {
-    constructor();
-}
-/** 当前时间（毫秒）。 */
-export declare function now(): number;
-/** 发一次宿主调用，等父进程的 `reply`。 */
-export declare function call(method: HostMethod, payload: unknown): Promise<unknown>;
-/** 等待 `ms` 毫秒；运行被取消时提前结束（调用方随后检查 `isAborted()`）。 */
-export declare function sleep(ms: number): Promise<void>;
-export declare function isAborted(): boolean;
-/** 是否因宿主要求提前结束（而不是取消）而中止。 */
-export declare function isStopped(): boolean;
-/** 宿主要求提前结束：触发 `ctx.signal`（`aborted` 置位、回调执行），拉取随后以 `stopped: true` 正常结束。 */
-export declare function requestStop(): void;
-export declare function throwIfAborted(): void;
-export declare function onAbort(listener: () => void): void;
-/** 发出最终结果（`result` / `failure`）；只生效一次。 */
-export declare function finish(message: Record<string, unknown>): void;
-export declare function isFinished(): boolean;
-/** 父进程消息（已由宿主侧 `parseParentMessage` 校验并重新序列化）。 */
-export declare function handle(json: string): void;
-/**
- * 触发到期的定时器并取走待发消息。返回 `{ out, wake, fired }`：`out` 是待发消息的 JSON 字符串，
- * `wake` 是距下一个定时器的毫秒数（没有则为 -1），`fired` 表示本次触发了定时器（宿主应在微任务跑完后再 poll 一次）。
- */
-export declare function poll(): string;

package/runtime/guest/bridge.js

@@ -1,187 +0,0 @@
-import { ConnectorError } from '../../errors.js';
-const jsonParse = JSON.parse;
-const jsonStringify = JSON.stringify;
-const dateNow = Date.now;
-const reflectApply = Reflect.apply;
-const mathMin = Math.min;
-const MapCtor = Map;
-export { jsonParse, jsonStringify };
-export class HostCallFailure extends ConnectorError {
-    status;
-    retryAfterMs;
-    constructor(code, message, status, retryAfterMs) {
-        super(code, message);
-        this.name = 'HostCallFailure';
-        this.status = status;
-        this.retryAfterMs = retryAfterMs;
-    }
-}
-export class CanceledError extends ConnectorError {
-    constructor() {
-        super('CANCELED', 'run was canceled');
-        this.name = 'CanceledError';
-    }
-}
-let nextCallId = 1;
-const pending = new MapCtor();
-let timers = [];
-let outbox = [];
-let finished = false;
-let aborted = false;
-let declared = false;
-let stopped = false;
-const abortListeners = [];
-function isRecord(value) {
-    return typeof value === 'object' && value !== null && !Array.isArray(value);
-}
-export function now() {
-    return reflectApply(dateNow, Date, []);
-}
-function enqueue(message) {
-    const text = jsonStringify(message);
-    if (typeof text !== 'string')
-        throw new TypeError('message is not serializable');
-    outbox[outbox.length] = text;
-}
-export function call(method, payload) {
-    if (method === 'declaration') {
-        if (declared)
-            return Promise.reject(new ConnectorError('FATAL_ERROR', 'declaration was already reported in this run'));
-        declared = true;
-    }
-    const id = nextCallId;
-    nextCallId += 1;
-    return new Promise((resolve, reject) => {
-        try {
-            enqueue({ type: 'call', id, method, payload });
-        }
-        catch (error) {
-            reject(new TypeError(`${method} payload is not serializable: ${error instanceof Error ? error.message : String(error)}`));
-            return;
-        }
-        pending.set(id, { resolve, reject });
-    });
-}
-export function sleep(ms) {
-    if (aborted || !(ms > 0))
-        return Promise.resolve();
-    return new Promise((resolve) => {
-        timers[timers.length] = { at: now() + ms, resolve };
-    });
-}
-export function isAborted() {
-    return aborted;
-}
-export function isStopped() {
-    return stopped;
-}
-export function requestStop() {
-    if (aborted)
-        return;
-    stopped = true;
-    abort();
-}
-export function throwIfAborted() {
-    if (aborted)
-        throw new CanceledError();
-}
-export function onAbort(listener) {
-    if (aborted) {
-        void Promise.resolve().then(() => runListener(listener));
-        return;
-    }
-    abortListeners[abortListeners.length] = listener;
-}
-function runListener(listener) {
-    try {
-        listener();
-    }
-    catch {
-    }
-}
-function abort() {
-    if (aborted)
-        return;
-    aborted = true;
-    const due = timers;
-    timers = [];
-    for (const timer of due)
-        timer.resolve();
-    for (const [id, entry] of pending) {
-        pending.delete(id);
-        entry.reject(new CanceledError());
-    }
-    const listeners = abortListeners.splice(0, abortListeners.length);
-    for (const listener of listeners)
-        runListener(listener);
-}
-export function finish(message) {
-    if (finished)
-        return;
-    finished = true;
-    try {
-        enqueue(message);
-    }
-    catch (error) {
-        outbox[outbox.length] = jsonStringify({
-            type: 'failure', code: 'FATAL_ERROR', logs: [],
-            message: `connector result is not serializable: ${error instanceof Error ? error.message : String(error)}`,
-        });
-    }
-}
-export function isFinished() {
-    return finished;
-}
-export function handle(json) {
-    if (typeof json !== 'string')
-        return;
-    let message;
-    try {
-        message = jsonParse(json);
-    }
-    catch {
-        return;
-    }
-    if (!isRecord(message))
-        return;
-    if (message.type === 'cancel') {
-        abort();
-        return;
-    }
-    if (message.type !== 'reply' || typeof message.id !== 'number')
-        return;
-    const entry = pending.get(message.id);
-    if (!entry)
-        return;
-    pending.delete(message.id);
-    if (message.ok === true) {
-        entry.resolve(message.value);
-        return;
-    }
-    const error = isRecord(message.error) ? message.error : {};
-    entry.reject(new HostCallFailure(typeof error.code === 'string' ? error.code : 'HOST_ERROR', typeof error.message === 'string' ? error.message : 'host call failed', typeof error.status === 'number' ? error.status : undefined, typeof error.retryAfterMs === 'number' ? error.retryAfterMs : undefined));
-}
-export function poll() {
-    const current = now();
-    let fired = false;
-    if (timers.length > 0) {
-        const due = [];
-        const rest = [];
-        for (const timer of timers) {
-            if (timer.at <= current)
-                due[due.length] = timer;
-            else
-                rest[rest.length] = timer;
-        }
-        timers = rest;
-        for (const timer of due)
-            timer.resolve();
-        fired = due.length > 0;
-    }
-    let wake = -1;
-    for (const timer of timers)
-        wake = wake < 0 ? timer.at - current : mathMin(wake, timer.at - current);
-    const out = outbox;
-    outbox = [];
-    return `{"out":[${out.join(',')}],"wake":${wake < 0 ? -1 : wake},"fired":${fired ? 'true' : 'false'}}`;
-}

package/runtime/guest/cache.d.ts

@@ -1,3 +0,0 @@
-/** `ctx.cache`：按连接隔离、跨运行保留的小型键值缓存，存在宿主侧（加密存储）。 */
-import type { ConnectorCache } from '../../types.js';
-export declare function createCache(): ConnectorCache;

package/runtime/guest/cache.js

@@ -1,42 +0,0 @@
-import { call, now } from './bridge.js';
-function key(value) {
-    if (typeof value !== 'string' || value.length === 0)
-        throw new TypeError('cache key must be a non-empty string');
-    return value;
-}
-function ttl(value) {
-    if (typeof value !== 'number' || !Number.isInteger(value) || value < 1)
-        throw new TypeError('cache ttlSeconds must be a positive integer');
-    return value;
-}
-async function get(name) {
-    const entry = await call('cache.get', { key: key(name) });
-    if (entry === null || typeof entry !== 'object' || typeof entry.value !== 'string')
-        return undefined;
-    const expiresAt = typeof entry.expiresAt === 'string' ? Date.parse(entry.expiresAt) : Number.NaN;
-    if (!Number.isNaN(expiresAt) && expiresAt <= now())
-        return undefined;
-    return entry.value;
-}
-async function set(name, value, ttlSeconds) {
-    if (typeof value !== 'string')
-        throw new TypeError('cache value must be a string');
-    await call('cache.set', { key: key(name), value, ttlSeconds: ttl(ttlSeconds) });
-}
-export function createCache() {
-    return Object.freeze({
-        get: (name) => Promise.resolve().then(() => get(name)),
-        set: (name, value, ttlSeconds) => Promise.resolve().then(() => set(name, value, ttlSeconds)),
-        async getOrSet(name, ttlSeconds, fn) {
-            ttl(ttlSeconds);
-            if (typeof fn !== 'function')
-                throw new TypeError('cache.getOrSet expects a function');
-            const cached = await get(name);
-            if (cached !== undefined)
-                return cached;
-            const value = await fn();
-            await set(name, value, ttlSeconds);
-            return value;
-        },
-    });
-}

package/runtime/guest/crypto.d.ts

@@ -1,13 +0,0 @@
-/**
- * `ctx.crypto`：`hmac` / `sign` / `hash` 走宿主（vm 上下文里没有 WebCrypto；`key` 可以是凭证句柄，由网关代算），
- * `base64Encode` / `base64Decode` 在 guest 里纯 JS 实现（按 UTF-8）。
- */
-import type { ConnectorCrypto } from '../../types.js';
-export declare function utf8Encode(input: string): number[];
-/** UTF-8 字节数，用于批次大小统计。 */
-export declare function utf8Length(input: string): number;
-export declare function bytesToBase64(bytes: readonly number[]): string;
-export declare function base64ToBytes(input: string): number[];
-export declare function base64Encode(input: string): string;
-export declare function base64Decode(input: string): string;
-export declare function createCrypto(): ConnectorCrypto;