base-link-core 0.1.0

package/dist/envelope.d.ts

@@ -0,0 +1,43 @@
+export declare const ENVELOPE_VERSION: "0.1.0";
+export declare const ENVELOPE_SHAPES: readonly ["list", "detail", "stat", "receipt", "analysis", "fallback"];
+export type EnvelopeShape = (typeof ENVELOPE_SHAPES)[number];
+export interface EnvelopeDataByShape {
+    list: {
+        items: unknown[];
+        total?: number;
+    };
+    detail: {
+        item: Record<string, unknown>;
+    };
+    stat: {
+        metrics: Record<string, number>;
+    };
+    receipt: {
+        ok: boolean;
+        message: string;
+    };
+    analysis: {
+        summary: string;
+    };
+    fallback: {
+        reason: string;
+        degraded: true;
+    };
+}
+export interface Envelope<S extends EnvelopeShape = EnvelopeShape> {
+    version: typeof ENVELOPE_VERSION;
+    skill: string;
+    shape: S;
+    key: string;
+    data: EnvelopeDataByShape[S];
+}
+export declare function assertShapeData(shape: EnvelopeShape, data: Record<string, unknown>): void;
+export declare function createEnvelope<S extends EnvelopeShape>(input: {
+    skill: string;
+    shape: S;
+    key: string;
+    data: EnvelopeDataByShape[S];
+}): Envelope<S>;
+export declare function parseEnvelope(input: unknown): Envelope;
+export declare function isEnvelope(input: unknown): input is Envelope;
+//# sourceMappingURL=envelope.d.ts.map

package/dist/envelope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.d.ts","sourceRoot":"","sources":["../src/envelope.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,gBAAgB,EAAG,OAAgB,CAAC;AAGjD,eAAO,MAAM,eAAe,wEAAyE,CAAC;AACtG,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7D,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE;QAAE,KAAK,EAAE,OAAO,EAAE,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;IAC1C,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC;IAC1C,OAAO,EAAE;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C,QAAQ,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9B,QAAQ,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,IAAI,CAAA;KAAE,CAAC;CAC9C;AAED,MAAM,WAAW,QAAQ,CAAC,CAAC,SAAS,aAAa,GAAG,aAAa;IAC/D,OAAO,EAAE,OAAO,gBAAgB,CAAC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,CAAC,CAAC;IAET,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC;CAC9B;AA0BD,wBAAgB,eAAe,CAAC,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAmCzF;AAED,wBAAgB,cAAc,CAAC,CAAC,SAAS,aAAa,EAAE,KAAK,EAAE;IAC7D,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,CAAC,CAAC;IACT,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC;CAC9B,GAAG,QAAQ,CAAC,CAAC,CAAC,CAQd;AAGD,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,CAYtD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAO5D"}

package/dist/envelope.js

@@ -0,0 +1,104 @@
+/**
+ * envelope：唯一出口载荷。6 形状全字段，semver 版本化。
+ * 零依赖：手写守卫（不用 Zod），保 P4 零依赖冻结；Zod 可后加于 combos/skill 层。
+ */
+import { EnvelopeError } from './errors.js';
+export const ENVELOPE_VERSION = '0.1.0';
+// 6 形状：list 今日列表 / detail 单条详情 / stat 聚合统计 / receipt 写入回执 / analysis 开放式分析(L6) / fallback 降级载荷
+export const ENVELOPE_SHAPES = ['list', 'detail', 'stat', 'receipt', 'analysis', 'fallback'];
+const SEMVER_RE = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:[-+].*)?$/;
+function vstr(v) { return String(v); }
+function assertSemverCompatible(version) {
+    if (typeof version !== 'string' || !SEMVER_RE.test(version)) {
+        throw new EnvelopeError('version 非法 semver：' + vstr(version));
+    }
+    const major = version.split('.')[0];
+    const want = ENVELOPE_VERSION.split('.')[0];
+    if (major !== want)
+        throw new EnvelopeError('version 主版本不兼容：' + version + '（当前 ' + ENVELOPE_VERSION + '）');
+}
+function assertNonEmptyString(value, field) {
+    if (typeof value !== 'string' || value.length === 0)
+        throw new EnvelopeError(field + ' 须为非空字符串');
+}
+function assertDataObject(data) {
+    if (typeof data !== 'object' || data === null || Array.isArray(data)) {
+        throw new EnvelopeError('data 须为对象（坏输入不返空数组）');
+    }
+}
+// 逐形状全字段校验：缺字段即 throw，不返空。
+export function assertShapeData(shape, data) {
+    switch (shape) {
+        case 'list':
+            if (!Array.isArray(data.items))
+                throw new EnvelopeError('list 形缺 items 数组');
+            if (data.total !== undefined && typeof data.total !== 'number')
+                throw new EnvelopeError('list 形 total 须为 number');
+            break;
+        case 'detail':
+            if (typeof data.item !== 'object' || data.item === null || Array.isArray(data.item)) {
+                throw new EnvelopeError('detail 形缺 item 对象');
+            }
+            break;
+        case 'stat':
+            if (typeof data.metrics !== 'object' || data.metrics === null || Array.isArray(data.metrics)) {
+                throw new EnvelopeError('stat 形缺 metrics 对象');
+            }
+            for (const v of Object.values(data.metrics)) {
+                if (typeof v !== 'number')
+                    throw new EnvelopeError('stat 形 metrics 值须全为 number');
+            }
+            break;
+        case 'receipt':
+            if (typeof data.ok !== 'boolean' || typeof data.message !== 'string') {
+                throw new EnvelopeError('receipt 形缺 ok/message 全字段');
+            }
+            break;
+        case 'analysis':
+            if (typeof data.summary !== 'string' || data.summary.length === 0) {
+                throw new EnvelopeError('analysis 形缺 summary 全字段');
+            }
+            break;
+        case 'fallback':
+            if (typeof data.reason !== 'string' || data.reason.length === 0 || data.degraded !== true) {
+                throw new EnvelopeError('fallback 形缺 reason/degraded:true 全字段（须显式标记降级）');
+            }
+            break;
+    }
+}
+export function createEnvelope(input) {
+    if (typeof input !== 'object' || input === null)
+        throw new EnvelopeError('入参须为对象');
+    assertNonEmptyString(input.skill, 'skill');
+    if (!ENVELOPE_SHAPES.includes(input.shape))
+        throw new EnvelopeError('未知 shape：' + vstr(input.shape));
+    assertNonEmptyString(input.key, 'key');
+    assertDataObject(input.data);
+    assertShapeData(input.shape, input.data);
+    return { version: ENVELOPE_VERSION, skill: input.skill, shape: input.shape, key: input.key, data: input.data };
+}
+// 校验未知输入（CLI/跨包边界）：合法返回 envelope，非法 throw。
+export function parseEnvelope(input) {
+    if (typeof input !== 'object' || input === null)
+        throw new EnvelopeError('envelope 须为对象');
+    const e = input;
+    assertSemverCompatible(e.version);
+    assertNonEmptyString(e.skill, 'skill');
+    if (typeof e.shape !== 'string' || !ENVELOPE_SHAPES.includes(e.shape)) {
+        throw new EnvelopeError('未知 shape：' + vstr(e.shape));
+    }
+    assertNonEmptyString(e.key, 'key');
+    assertDataObject(e.data);
+    assertShapeData(e.shape, e.data);
+    return { version: ENVELOPE_VERSION, skill: e.skill, shape: e.shape, key: e.key, data: e.data };
+}
+export function isEnvelope(input) {
+    try {
+        parseEnvelope(input);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=envelope.js.map

package/dist/envelope.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,23 @@
+/** link-core 错误基类：坏输入一律 throw，永不返空数组冒充正常。 */
+export declare class LinkCoreError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string, options?: {
+        cause?: unknown;
+    });
+}
+export declare class EnvelopeError extends LinkCoreError {
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+export declare class RegistryError extends LinkCoreError {
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+export declare class RunnerError extends LinkCoreError {
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qBAAa,aAAc,SAAQ,KAAK;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBACV,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAKzE;AAED,qBAAa,aAAc,SAAQ,aAAa;gBAClC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAI3D;AAED,qBAAa,aAAc,SAAQ,aAAa;gBAClC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAI3D;AAED,qBAAa,WAAY,SAAQ,aAAa;gBAChC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAI3D"}

package/dist/errors.js

@@ -0,0 +1,28 @@
+/** link-core 错误基类：坏输入一律 throw，永不返空数组冒充正常。 */
+export class LinkCoreError extends Error {
+    code;
+    constructor(code, message, options) {
+        super(message, options);
+        this.name = 'LinkCoreError';
+        this.code = code;
+    }
+}
+export class EnvelopeError extends LinkCoreError {
+    constructor(message, options) {
+        super('ENVELOPE_INVALID', message, options);
+        this.name = 'EnvelopeError';
+    }
+}
+export class RegistryError extends LinkCoreError {
+    constructor(message, options) {
+        super('REGISTRY_UNKNOWN_KEY', message, options);
+        this.name = 'RegistryError';
+    }
+}
+export class RunnerError extends LinkCoreError {
+    constructor(message, options) {
+        super('RUNNER_FAILED', message, options);
+        this.name = 'RunnerError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,MAAM,OAAO,aAAc,SAAQ,KAAK;IAC7B,IAAI,CAAS;IACtB,YAAY,IAAY,EAAE,OAAe,EAAE,OAA6B;QACtE,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED,MAAM,OAAO,aAAc,SAAQ,aAAa;IAC9C,YAAY,OAAe,EAAE,OAA6B;QACxD,KAAK,CAAC,kBAAkB,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAC5C,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,OAAO,aAAc,SAAQ,aAAa;IAC9C,YAAY,OAAe,EAAE,OAA6B;QACxD,KAAK,CAAC,sBAAsB,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAChD,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,OAAO,WAAY,SAAQ,aAAa;IAC5C,YAAY,OAAe,EAAE,OAA6B;QACxD,KAAK,CAAC,eAAe,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { ENVELOPE_VERSION, ENVELOPE_SHAPES, createEnvelope, parseEnvelope, isEnvelope, assertShapeData } from './envelope.js';
+export type { Envelope, EnvelopeShape, EnvelopeDataByShape } from './envelope.js';
+export { createRegistry, parseRegistryKey } from './registry.js';
+export type { Registry, RegistryKey, ParsedKey } from './registry.js';
+export { runCombo } from './runner.js';
+export type { RunRequest, Fetcher } from './runner.js';
+export { LinkCoreError, EnvelopeError, RegistryError, RunnerError } from './errors.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,cAAc,EAAE,aAAa,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC9H,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAClF,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjE,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AACtE,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,YAAY,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+// link-core：沉底零依赖。envelope 全字段 + registry key 类型 + runner 契约。
+export { ENVELOPE_VERSION, ENVELOPE_SHAPES, createEnvelope, parseEnvelope, isEnvelope, assertShapeData } from './envelope.js';
+export { createRegistry, parseRegistryKey } from './registry.js';
+export { runCombo } from './runner.js';
+export { LinkCoreError, EnvelopeError, RegistryError, RunnerError } from './errors.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,cAAc,EAAE,aAAa,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAE9H,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjE,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}

package/dist/registry.d.ts

@@ -0,0 +1,14 @@
+export type RegistryKey = string;
+export interface ParsedKey {
+    skill: string;
+    combo: string;
+    key: string;
+}
+export declare function parseRegistryKey(raw: unknown): ParsedKey;
+export interface Registry {
+    keys(): string[];
+    has(key: string): boolean;
+    resolve(key: string): ParsedKey;
+}
+export declare function createRegistry(knownKeys: readonly string[]): Registry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC;AAIjC,MAAM,WAAW,SAAS;IAAG,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;CAAE;AAGzE,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,SAAS,CAWxD;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,IAAI,MAAM,EAAE,CAAC;IACjB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC1B,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,GAAG,QAAQ,CAcrE"}

package/dist/registry.js

@@ -0,0 +1,40 @@
+// registry：电话本。key 语法 skill.combo 命名空间修复：裸 key 拒绝并给修复提示；对不上注册表即 fail。
+import { RegistryError } from './errors.js';
+const KEY_RE = /^[a-z][a-z0-9-]*\.[a-z0-9][a-z0-9-.]*$/;
+// 命名空间修复：trim + 小写化仅做提示，正文保持原样校验；裸 key（如 today）拒绝，提示补命名空间为 <skill>.today。
+export function parseRegistryKey(raw) {
+    if (typeof raw !== 'string' || raw.length === 0)
+        throw new RegistryError('registry key 须为非空字符串');
+    const key = raw.trim();
+    if (!KEY_RE.test(key)) {
+        const hint = key.includes('.')
+            ? '命名空间非法，形如 skill.combo'
+            : '缺命名空间，应为 <skill>.' + key;
+        throw new RegistryError('非法 registry key：' + JSON.stringify(raw) + '（' + hint + '）');
+    }
+    const dot = key.indexOf('.');
+    return { skill: key.slice(0, dot), combo: key.slice(dot + 1), key };
+}
+export function createRegistry(knownKeys) {
+    const set = new Set();
+    for (const k of knownKeys)
+        set.add(parseRegistryKey(k).key);
+    return {
+        keys: () => [...set],
+        has: (key) => {
+            try {
+                return set.has(parseRegistryKey(key).key);
+            }
+            catch {
+                return false;
+            }
+        },
+        resolve: (key) => {
+            const parsed = parseRegistryKey(key);
+            if (!set.has(parsed.key))
+                throw new RegistryError('未知 registry key：' + parsed.key + '（对不上即 fail，不返空）');
+            return parsed;
+        },
+    };
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAI5C,MAAM,MAAM,GAAG,wCAAwC,CAAC;AAIxD,0EAA0E;AAC1E,MAAM,UAAU,gBAAgB,CAAC,GAAY;IAC3C,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,aAAa,CAAC,sBAAsB,CAAC,CAAC;IACjG,MAAM,GAAG,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IACvB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC;YAC5B,CAAC,CAAC,uBAAuB;YACzB,CAAC,CAAC,mBAAmB,GAAG,GAAG,CAAC;QAC9B,MAAM,IAAI,aAAa,CAAC,kBAAkB,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,IAAI,GAAG,GAAG,CAAC,CAAC;IACvF,CAAC;IACD,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC7B,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC;AACtE,CAAC;AAQD,MAAM,UAAU,cAAc,CAAC,SAA4B;IACzD,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,KAAK,MAAM,CAAC,IAAI,SAAS;QAAE,GAAG,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAC5D,OAAO;QACL,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC;QACpB,GAAG,EAAE,CAAC,GAAW,EAAE,EAAE;YACnB,IAAI,CAAC;gBAAC,OAAO,GAAG,CAAC,GAAG,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC;gBAAC,OAAO,KAAK,CAAC;YAAC,CAAC;QAC5E,CAAC;QACD,OAAO,EAAE,CAAC,GAAW,EAAE,EAAE;YACvB,MAAM,MAAM,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;YACrC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC;gBAAE,MAAM,IAAI,aAAa,CAAC,kBAAkB,GAAG,MAAM,CAAC,GAAG,GAAG,iBAAiB,CAAC,CAAC;YACvG,OAAO,MAAM,CAAC;QAChB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/runner.d.ts

@@ -0,0 +1,16 @@
+import { type Envelope, type EnvelopeShape, type EnvelopeDataByShape } from './envelope.js';
+import type { Registry } from './registry.js';
+export interface RunRequest<S extends EnvelopeShape> {
+    key: string;
+    shape: S;
+    params?: Record<string, unknown>;
+    signal?: AbortSignal;
+}
+export type Fetcher<S extends EnvelopeShape> = (req: {
+    skill: string;
+    combo: string;
+    params: Record<string, unknown>;
+    signal?: AbortSignal;
+}) => Promise<EnvelopeDataByShape[S]> | EnvelopeDataByShape[S];
+export declare function runCombo<S extends EnvelopeShape>(registry: Registry, req: RunRequest<S>, fetchData: Fetcher<S>): Promise<Envelope<S>>;
+//# sourceMappingURL=runner.d.ts.map

package/dist/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AACA,OAAO,EAAkB,KAAK,QAAQ,EAAE,KAAK,aAAa,EAAE,KAAK,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAE5G,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,MAAM,WAAW,UAAU,CAAC,CAAC,SAAS,aAAa;IACjD,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,CAAC,CAAC;IACT,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,MAAM,OAAO,CAAC,CAAC,SAAS,aAAa,IAAI,CAC7C,GAAG,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,KACzF,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,GAAG,mBAAmB,CAAC,CAAC,CAAC,CAAC;AAE9D,wBAAsB,QAAQ,CAAC,CAAC,SAAS,aAAa,EACpD,QAAQ,EAAE,QAAQ,EAClB,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,EAClB,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,GACpB,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAuBtB"}

package/dist/runner.js

@@ -0,0 +1,33 @@
+// runner：唯一取数编排。key 先过 registry，载荷再过 envelope 全字段；失败 throw，永不合成空数组。
+import { createEnvelope } from './envelope.js';
+import { RunnerError } from './errors.js';
+export async function runCombo(registry, req, fetchData) {
+    if (typeof req !== 'object' || req === null)
+        throw new RunnerError('请求须为对象');
+    let skill = '';
+    try {
+        skill = registry.resolve(req.key).skill;
+    }
+    catch (e) {
+        throw new RunnerError('key 解析失败：' + e.message, { cause: e });
+    }
+    if (req.params !== undefined && (typeof req.params !== 'object' || req.params === null || Array.isArray(req.params))) {
+        throw new RunnerError('params 须为对象');
+    }
+    let data;
+    try {
+        data = await fetchData({ skill, combo: req.key.split('.').slice(1).join('.'), params: req.params ?? {}, signal: req.signal });
+    }
+    catch (e) {
+        if (e instanceof RunnerError)
+            throw e;
+        throw new RunnerError('取数失败：' + e.message, { cause: e });
+    }
+    try {
+        return createEnvelope({ skill, shape: req.shape, key: req.key, data });
+    }
+    catch (e) {
+        throw new RunnerError('载荷未过 envelope 全字段：' + e.message, { cause: e });
+    }
+}
+//# sourceMappingURL=runner.js.map

package/dist/runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.js","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,OAAO,EAAE,cAAc,EAA+D,MAAM,eAAe,CAAC;AAC5G,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAc1C,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,QAAkB,EAClB,GAAkB,EAClB,SAAqB;IAErB,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI;QAAE,MAAM,IAAI,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC7E,IAAI,KAAK,GAAG,EAAE,CAAC;IACf,IAAI,CAAC;QACH,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC;IAC1C,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,WAAW,CAAC,WAAW,GAAI,CAAW,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;IAC1E,CAAC;IACD,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;QACrH,MAAM,IAAI,WAAW,CAAC,aAAa,CAAC,CAAC;IACvC,CAAC;IACD,IAAI,IAA4B,CAAC;IACjC,IAAI,CAAC;QACH,IAAI,GAAG,MAAM,SAAS,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;IAChI,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAI,CAAC,YAAY,WAAW;YAAE,MAAM,CAAC,CAAC;QACtC,MAAM,IAAI,WAAW,CAAC,OAAO,GAAI,CAAW,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;IACtE,CAAC;IACD,IAAI,CAAC;QACH,OAAO,cAAc,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;IACzE,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,WAAW,CAAC,oBAAoB,GAAI,CAAW,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;IACnF,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "base-link-core",
+  "version": "0.1.0",
+  "description": "联动沉底包：envelope+registry+runner+校验，零依赖",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=22.13"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "test": "node --test ../../test/scaffold.test.mjs"
+  }
+}