@gt-fe/eap-runtime 0.0.30 → 0.0.32

package/dist/tool/skill-relative-read.d.ts

@@ -0,0 +1,14 @@
+export declare function userReadBase(workdir: string | undefined): string | undefined;
+/**
+ * 相对 read_file：`技能名/文件`、全库唯一命中、显式 skillDir，否则用户目录。
+ */
+export declare function locateSkillRelativeRead(filePath: string, workdir: string | undefined, skillDir: string | undefined, extraRoots?: string[]): {
+    path: string;
+    relativeBase: string | undefined;
+};
+/** 定位符落到实际文件：绝对路径原样；相对路径按 locateSkillRelativeRead 的包根拼接。 */
+export declare function resolveSkillReadTarget(filePath: string, opts?: {
+    workdir?: string;
+    skillDir?: string;
+    extraRoots?: string[];
+}): string;

package/dist/tool/skill-relative-read.js

@@ -0,0 +1,98 @@
+/**
+ * read_file 相对路径如何落到技能包：Harness 读文件与 Trace 判定入口共用。
+ */
+import { existsSync, readdirSync, realpathSync } from 'node:fs';
+import path from 'node:path';
+function tryRealpath(p) {
+    try {
+        return realpathSync(p);
+    }
+    catch {
+        return undefined;
+    }
+}
+export function userReadBase(workdir) {
+    return workdir?.trim()
+        ? (tryRealpath(path.resolve(workdir)) ?? path.resolve(workdir))
+        : undefined;
+}
+function isSkillPackageDir(dir) {
+    return existsSync(path.join(dir, 'SKILL.md')) || existsSync(path.join(dir, 'skill.md'));
+}
+function skillPackageRoots(roots) {
+    const out = [];
+    const seen = new Set();
+    const add = (dir) => {
+        if (seen.has(dir))
+            return;
+        seen.add(dir);
+        out.push(dir);
+    };
+    for (const root of roots) {
+        const resolved = path.resolve(root);
+        if (isSkillPackageDir(resolved)) {
+            add(resolved);
+            continue;
+        }
+        let entries;
+        try {
+            entries = readdirSync(resolved, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        for (const ent of entries) {
+            if (!ent.isDirectory())
+                continue;
+            const child = path.join(resolved, ent.name);
+            if (isSkillPackageDir(child))
+                add(child);
+        }
+    }
+    return out;
+}
+/**
+ * 相对 read_file：`技能名/文件`、全库唯一命中、显式 skillDir，否则用户目录。
+ */
+export function locateSkillRelativeRead(filePath, workdir, skillDir, extraRoots) {
+    const trimmed = filePath.trim();
+    const userBase = userReadBase(workdir);
+    if (!trimmed || path.isAbsolute(trimmed))
+        return { path: trimmed, relativeBase: userBase };
+    const packages = skillPackageRoots([
+        ...(skillDir?.trim() ? [skillDir] : []),
+        ...(extraRoots ?? []),
+    ]);
+    const slash = trimmed.replace(/\\/g, '/');
+    const segs = slash.split('/').filter(Boolean);
+    if (segs.length >= 2) {
+        const hit = packages.find((pkg) => path.basename(pkg) === segs[0]);
+        if (hit)
+            return { path: segs.slice(1).join('/'), relativeBase: hit };
+    }
+    const matches = packages.filter((pkg) => existsSync(path.resolve(pkg, trimmed)));
+    if (matches.length === 1)
+        return { path: trimmed, relativeBase: matches[0] };
+    const skillBase = skillDir?.trim() ? path.resolve(skillDir) : undefined;
+    if (skillBase && existsSync(path.resolve(skillBase, trimmed))) {
+        return { path: trimmed, relativeBase: skillBase };
+    }
+    return { path: trimmed, relativeBase: userBase };
+}
+/** 定位符落到实际文件：绝对路径原样；相对路径按 locateSkillRelativeRead 的包根拼接。 */
+export function resolveSkillReadTarget(filePath, opts) {
+    const trimmed = filePath.trim();
+    if (!trimmed)
+        return '';
+    const located = locateSkillRelativeRead(trimmed, opts?.workdir, opts?.skillDir, opts?.extraRoots);
+    if (path.isAbsolute(trimmed)) {
+        const resolved = path.resolve(trimmed);
+        return (tryRealpath(resolved) ?? resolved).replace(/\\/g, '/').replace(/\/+$/, '');
+    }
+    if (located.relativeBase) {
+        const resolved = path.resolve(located.relativeBase, located.path);
+        return (tryRealpath(resolved) ?? resolved).replace(/\\/g, '/').replace(/\/+$/, '');
+    }
+    const resolved = path.resolve(trimmed);
+    return (tryRealpath(resolved) ?? resolved).replace(/\\/g, '/').replace(/\/+$/, '');
+}

package/dist/tool/static-artifact-url.d.ts

@@ -0,0 +1,66 @@
+/**
+ * 用户产物公开副本：files/ 工作稿 → public/ 时间戳 copy；拼 Hosting /static url。
+ * @see docs/design/user-artifact-delivery.md
+ */
+/** 与 contracts `DEFAULT_BUILTIN_MAX_WRITE_BYTES` 同值；本地编译不依赖未发版 contracts */
+export declare const DEFAULT_MAX_WRITE_BYTES: number;
+export declare const PUBLIC_DIR_MODE = 493;
+export declare const PUBLIC_FILE_MODE = 420;
+export declare const MAX_SNAPSHOT_ENUM = 5000;
+export declare const MAX_SNAPSHOT_URLS = 20;
+export declare const MAX_PUBLIC_NAME_ATTEMPTS = 8;
+export declare const PUBLIC_EXTENSIONS: Set<string>;
+export type ArtifactEnv = NodeJS.ProcessEnv | Record<string, string | undefined>;
+export type PublishedArtifact = {
+    fileName: string;
+    fileType: string;
+    size: number;
+    url?: string;
+    absPath: string;
+    /** 工作稿相对 `files/` 的路径 */
+    sourceRel?: string;
+};
+export declare function staticBaseUrlFromEnv(env?: ArtifactEnv): string | undefined;
+export declare function preinstallRootFromEnv(env?: ArtifactEnv): string | undefined;
+export declare function encodePublicRel(rel: string): string;
+export declare function isPublicUserArtifactRel(rel: string): boolean;
+export declare function publicArtifactUrl(absPath: string, env?: ArtifactEnv): string | undefined;
+export declare function publicTimeSuffix(now?: Date, withMs?: boolean): string;
+export declare function stripPublicSuffix(name: string): string;
+export declare function extensionOf(name: string): string;
+export declare function isPublicExtension(name: string): boolean;
+export declare function isSnapshotJunkName(name: string): boolean;
+export declare function mkdirChmod(dir: string, mode?: number): Promise<void>;
+/** 四槽 `skills/` `work/` `files/` `public/`，目录 0755（与 Hosting `ensureUserWorkspace` 对齐）。 */
+export declare function ensureUserSlots(userDir: string): Promise<{
+    filesDir: string;
+    workDir: string;
+    publicDir: string;
+    skillsDir: string;
+}>;
+export declare function allocPublicBasename(publicDir: string, srcFile: string, originalBasename: string): Promise<string | undefined>;
+export declare function allocPublicDir(publicDir: string, srcDir: string, originalDirName: string): Promise<string | undefined>;
+export declare function publishFromFiles(userDir: string, relFromFiles: string[], env?: ArtifactEnv): Promise<PublishedArtifact[]>;
+export type FilesWalkEntry = {
+    rel: string;
+    size: number;
+    mtimeMs: number;
+    ctimeMs: number;
+};
+export declare function walkFilesTree(filesDir: string): Promise<{
+    entries: Map<string, FilesWalkEntry>;
+    truncated: boolean;
+}>;
+export declare function snapshotCandidates(before: Map<string, FilesWalkEntry>, after: Map<string, FilesWalkEntry>, maxWriteBytes?: number): {
+    rels: string[];
+    skippedOversize: number;
+};
+export type UserProductSlot = 'files' | 'skills';
+export type ResolvedUserProductPath = {
+    abs: string;
+    jsonPath: string;
+    slot: UserProductSlot;
+    relFromFiles?: string;
+};
+export declare function resolveUserProductPath(requested: string, userDir: string, kind: 'write' | 'cwd' | 'read'): ResolvedUserProductPath;
+export declare function maxWriteBytesFromEnv(env?: ArtifactEnv): number;