@gt-fe/eap-runtime 0.0.30 → 0.0.31

package/dist/tool/inject-public-artifact-links.js

@@ -0,0 +1,142 @@
+/**
+ * 本轮带 url 的公开副本 → 助手正文末尾 GFM 链接。
+ * stream / streamResumeHitl / stream.handler / invoke.handler 共用。
+ */
+function escapeMdLinkText(text) {
+    return text.replace(/\\/g, '\\\\').replace(/([\[\]()])/g, '\\$1');
+}
+function addLink(out, seen, fileName, url) {
+    const href = url.trim();
+    if (!href || seen.has(href))
+        return;
+    seen.add(href);
+    out.push({ fileName: fileName.trim() || href, url: href });
+}
+function parseContentLinks(content, out, seen) {
+    if (typeof content !== 'string' || !content.trim())
+        return;
+    const first = content.split('\n', 1)[0] ?? '';
+    try {
+        const parsed = JSON.parse(first);
+        if (Array.isArray(parsed.publicFiles)) {
+            for (const item of parsed.publicFiles) {
+                if (!item || typeof item !== 'object')
+                    continue;
+                const row = item;
+                if (typeof row.url === 'string') {
+                    const name = (typeof row.fileName === 'string' && row.fileName) ||
+                        (typeof row.path === 'string' && row.path) ||
+                        'file';
+                    addLink(out, seen, name, row.url);
+                }
+            }
+            return;
+        }
+        if (parsed.ok === true && typeof parsed.url === 'string') {
+            const name = typeof parsed.path === 'string' ? parsed.path : 'file';
+            addLink(out, seen, name, parsed.url);
+        }
+    }
+    catch {
+        // 非 JSON 行忽略
+    }
+}
+export function mergeArtifactLinks(...groups) {
+    const out = [];
+    const seen = new Set();
+    for (const group of groups) {
+        for (const item of group)
+            addLink(out, seen, item.fileName, item.url);
+    }
+    return out;
+}
+export function collectPublicArtifactLinks(results) {
+    const out = [];
+    const seen = new Set();
+    for (const result of results) {
+        if (result.file?.url) {
+            addLink(out, seen, result.file.fileName ?? result.file.url, result.file.url);
+        }
+        for (const f of result.files ?? []) {
+            if (f?.url)
+                addLink(out, seen, f.fileName ?? f.url, f.url);
+        }
+        parseContentLinks(result.content, out, seen);
+    }
+    return out;
+}
+export function collectPublicArtifactLinksFromEvent(eventType, payload, bucket) {
+    if (!payload || typeof payload !== 'object')
+        return;
+    const p = payload;
+    const seen = new Set(bucket.map((l) => l.url));
+    if (eventType === 'file.created' && typeof p.url === 'string') {
+        addLink(bucket, seen, typeof p.fileName === 'string' ? p.fileName : p.url, p.url);
+        return;
+    }
+    if (eventType === 'tool.result' || eventType === 'tool.error') {
+        const extra = collectPublicArtifactLinks([
+            { content: p.content, file: p.file, files: p.files },
+        ]);
+        for (const link of extra)
+            addLink(bucket, seen, link.fileName, link.url);
+    }
+}
+export function toolResultHasArtifacts(result) {
+    if (result.file?.url)
+        return true;
+    if ((result.files ?? []).some((f) => Boolean(f?.url)))
+        return true;
+    if (typeof result.content !== 'string' || !result.content.trim())
+        return false;
+    const first = result.content.split('\n', 1)[0] ?? '';
+    try {
+        const parsed = JSON.parse(first);
+        if (Array.isArray(parsed.publicFiles) && parsed.publicFiles.length > 0)
+            return true;
+        if (parsed.ok === true && typeof parsed.url === 'string' && parsed.url)
+            return true;
+    }
+    catch {
+        return false;
+    }
+    return false;
+}
+export function applyInjectedAssistant(messages, injected, links) {
+    if (!injected || links.length === 0)
+        return messages;
+    let idx = -1;
+    for (let i = messages.length - 1; i >= 0; i--) {
+        const m = messages[i];
+        if (m.role !== 'assistant')
+            continue;
+        if (!m.content.trim())
+            continue;
+        idx = i;
+        break;
+    }
+    if (idx >= 0) {
+        const copy = messages.slice();
+        copy[idx] = { ...copy[idx], content: injected };
+        return copy;
+    }
+    return [...messages, { role: 'assistant', content: injected }];
+}
+export function injectPublicArtifactLinks(visibleText, artifacts) {
+    const seen = new Set();
+    const lines = [];
+    for (const item of artifacts) {
+        const url = item.url.trim();
+        if (!url || seen.has(url))
+            continue;
+        seen.add(url);
+        if (visibleText.includes(url))
+            continue;
+        lines.push(`[${escapeMdLinkText(item.fileName)}](${url})`);
+    }
+    if (lines.length === 0)
+        return { injected: visibleText, suffix: '' };
+    const block = lines.join('\n');
+    const suffix = visibleText ? `\n\n${block}` : block;
+    return { injected: `${visibleText}${suffix}`, suffix };
+}

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;