session-viewer-plugin 0.1.0

package/server/dist/services/agcCredentials.js

@@ -0,0 +1,117 @@
+// AGC（华为云存储）凭证解析：按「环境变量 > 包内默认文件」优先级提供当前生效凭证。
+// 环境变量支持两种形态：AGC_CREDENTIALS_FILE 指向凭证 JSON 文件、AGC_CREDENTIALS_JSON 为内联 JSON 字符串；
+// 包内默认文件为随包发布的 assets/agc-apiclient.json，环境变量未设置时兜底。
+// 凭证在进程生命周期内不变，解析结果进程内缓存。
+import fs from 'fs/promises';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { CloudStorageError } from './cloudError.js';
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+/** 包内默认凭证文件路径（随包发布，作为最低优先级兜底） */
+const BUNDLED_CREDENTIALS_FILE = path.join(__dirname, '..', 'assets', 'agc-apiclient.json');
+/** 凭证必填字段（缺任一即视为无效凭证） */
+const REQUIRED_FIELDS = [
+    'client_id',
+    'client_secret',
+    'project_id',
+    'bucket_name',
+];
+/** 已成功解析的凭证缓存（凭证进程内不变，无需失效机制） */
+let cached = null;
+/**
+ * 校验凭证对象是否包含全部必填字段。
+ * @param cred 待校验的凭证对象
+ * @returns 缺失字段说明；校验通过返回 null
+ */
+function validateCredentials(cred) {
+    const missing = REQUIRED_FIELDS.filter((field) => !String(cred[field] ?? '').trim());
+    return missing.length > 0 ? `缺少必填字段: ${missing.join(', ')}` : null;
+}
+/**
+ * 读取并解析 JSON 凭证文件。
+ * @param filePath 凭证文件绝对路径
+ * @returns 解析后的凭证对象
+ * @throws 文件不存在或内容不是合法 JSON 时抛错
+ */
+async function readCredentialsFile(filePath) {
+    const raw = await fs.readFile(filePath, 'utf-8');
+    return JSON.parse(raw);
+}
+/**
+ * 从环境变量读取凭证（文件路径或内联 JSON 二选一）。
+ * @returns 凭证对象；未设置相关环境变量时返回 null
+ */
+async function resolveFromEnv() {
+    const filePath = process.env.AGC_CREDENTIALS_FILE?.trim();
+    if (filePath) {
+        return readCredentialsFile(path.resolve(filePath));
+    }
+    const inlineJson = process.env.AGC_CREDENTIALS_JSON?.trim();
+    if (inlineJson) {
+        return JSON.parse(inlineJson);
+    }
+    return null;
+}
+/**
+ * 补齐凭证可选字段默认值（region 缺省按 CN 站点处理）。
+ * @param cred 原始凭证对象（应已通过必填校验）
+ * @returns 字段完整的凭证对象
+ */
+function normalizeCredentials(cred) {
+    return {
+        type: cred.type ?? '',
+        developer_id: cred.developer_id ?? '',
+        project_id: cred.project_id ?? '',
+        client_id: cred.client_id ?? '',
+        client_secret: cred.client_secret ?? '',
+        configuration_version: cred.configuration_version ?? '',
+        region: cred.region?.trim() || 'CN',
+        bucket_name: cred.bucket_name ?? '',
+    };
+}
+/**
+ * 按优先级解析凭证：环境变量 > 包内默认文件。
+ * 已设置的来源优先级最高，即使其内容无效也不再降级（避免静默使用错误配置）。
+ * @returns 成功时返回凭证与来源；全部来源不可用时返回错误说明
+ */
+async function resolveCredentialSources() {
+    try {
+        const envCred = await resolveFromEnv();
+        if (envCred) {
+            const invalid = validateCredentials(envCred);
+            if (invalid)
+                return { error: `环境变量凭证无效: ${invalid}` };
+            return { cred: normalizeCredentials(envCred), source: 'env' };
+        }
+    }
+    catch (err) {
+        return { error: `环境变量凭证读取失败: ${err.message}` };
+    }
+    try {
+        const bundledCred = await readCredentialsFile(BUNDLED_CREDENTIALS_FILE);
+        const invalid = validateCredentials(bundledCred);
+        if (invalid)
+            return { error: `包内默认凭证无效: ${invalid}` };
+        return { cred: normalizeCredentials(bundledCred), source: 'default' };
+    }
+    catch {
+        return {
+            error: '未配置 AGC 凭证：请设置 AGC_CREDENTIALS_FILE 或 AGC_CREDENTIALS_JSON 环境变量（发布包不含凭证文件，源码运行时可用 src/assets/agc-apiclient.json 兜底）',
+        };
+    }
+}
+/**
+ * 获取当前生效的 AGC 凭证（结果进程内缓存）。
+ * @returns 当前生效的凭证对象
+ * @throws 所有来源均不可用时抛出 CloudStorageError（503）
+ */
+export async function resolveAgcCredentials() {
+    if (cached)
+        return cached.cred;
+    const result = await resolveCredentialSources();
+    if ('error' in result) {
+        throw new CloudStorageError(result.error, 503);
+    }
+    cached = { cred: result.cred, source: result.source };
+    return result.cred;
+}

package/server/dist/services/assembler.js

@@ -0,0 +1,171 @@
+import fs from 'fs/promises';
+import path from 'path';
+// ─── Token aggregation ───────────────────────────────────────
+const EMPTY_TOKENS = {
+    input: 0,
+    output: 0,
+    reasoning: 0,
+    cacheRead: 0,
+    cacheWrite: 0,
+    total: 0,
+};
+/** Element-wise sum of token usages. Derived fields (cacheHitRate/avg) are not summed. */
+function sumTokens(items) {
+    return items.reduce((acc, t) => ({
+        input: acc.input + (t.input ?? 0),
+        output: acc.output + (t.output ?? 0),
+        reasoning: acc.reasoning + (t.reasoning ?? 0),
+        cacheRead: acc.cacheRead + (t.cacheRead ?? 0),
+        cacheWrite: acc.cacheWrite + (t.cacheWrite ?? 0),
+        total: acc.total + (t.total ?? 0),
+    }), { ...EMPTY_TOKENS });
+}
+// ─── In-memory cache ──────────────────────────────────────────
+const CACHE_TTL = 30_000; // 30 seconds
+const sessionsCache = new Map();
+const detailCache = new Map();
+function cacheKey(dirs) {
+    return dirs.slice().sort().join('|');
+}
+function getCached(map, key) {
+    const entry = map.get(key);
+    if (!entry)
+        return null;
+    if (Date.now() - entry.ts > CACHE_TTL) {
+        map.delete(key);
+        return null;
+    }
+    return entry.data;
+}
+function setCache(map, key, data) {
+    map.set(key, { data, ts: Date.now() });
+}
+// ─── File reading ─────────────────────────────────────────────
+async function readSessionFile(filePath) {
+    try {
+        const content = await fs.readFile(filePath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch (err) {
+        console.error('Error reading file:', filePath, err);
+        return null;
+    }
+}
+function subtractTokens(a, b) {
+    return {
+        input: (a.input ?? 0) - (b.input ?? 0),
+        output: (a.output ?? 0) - (b.output ?? 0),
+        reasoning: (a.reasoning ?? 0) - (b.reasoning ?? 0),
+        cacheRead: (a.cacheRead ?? 0) - (b.cacheRead ?? 0),
+        cacheWrite: (a.cacheWrite ?? 0) - (b.cacheWrite ?? 0),
+        total: (a.total ?? 0) - (b.total ?? 0),
+    };
+}
+function sessionToSummary(m, id, filePath) {
+    const subagents = m.subagents ?? [];
+    const subagentTokens = subagents.length > 0 ? sumTokens(subagents.map((s) => s.tokens)) : undefined;
+    const mainTokens = subagentTokens ? subtractTokens(m.tokens, subagentTokens) : undefined;
+    const rawFirst = m.rounds?.find((r) => r.userMessage)?.userMessage;
+    const firstUserMessage = Array.isArray(rawFirst) ? rawFirst[0] : rawFirst;
+    return {
+        id,
+        sessionId: m.sessionId,
+        directory: m.header.workingDirectory,
+        model: m.header.model,
+        agent: m.header.agent,
+        stepCount: m.steps.length,
+        totalTokens: m.tokens,
+        mainTokens,
+        subagentTokens,
+        subagentCount: subagents.length > 0 ? subagents.length : undefined,
+        totalCost: 0,
+        duration: m.duration,
+        createdAt: m.header.startTime,
+        startTime: m.startTime,
+        endTime: m.endTime,
+        toolCalls: m.tools.totalCalls,
+        successRate: m.tools.successRate,
+        firstUserMessage,
+        filePath,
+    };
+}
+function sessionToDetail(m, id) {
+    const summary = sessionToSummary(m, id);
+    return {
+        ...summary,
+        steps: m.steps,
+        tools: m.tools,
+        codeStats: m.codeStats,
+        rounds: m.rounds,
+        subagents: m.subagents,
+        skills: m.skills,
+        planning: m.planning,
+        systemPrompts: m.systemPrompts,
+    };
+}
+export function invalidateCache() {
+    sessionsCache.clear();
+    detailCache.clear();
+}
+export async function getSessions(dirs) {
+    const key = cacheKey(dirs);
+    const cached = getCached(sessionsCache, key);
+    if (cached)
+        return cached;
+    const seen = new Map();
+    // Read all directories in parallel
+    const dirResults = await Promise.allSettled(dirs.map(async (dir) => {
+        console.error('[getSessions] Reading directory:', dir);
+        const files = await fs.readdir(dir);
+        const jsonFiles = files.filter((f) => f.endsWith('.json')).sort();
+        console.error('[getSessions] JSON files:', jsonFiles.length, 'in', dir);
+        // Read all files in a directory in parallel, tracking file paths
+        const fileResults = await Promise.allSettled(jsonFiles.map(async (file) => {
+            const filePath = path.join(dir, file);
+            const session = await readSessionFile(filePath);
+            return { session, filePath, id: file.slice(0, -'.json'.length) };
+        }));
+        return fileResults;
+    }));
+    for (const result of dirResults) {
+        if (result.status === 'rejected')
+            continue;
+        for (const fileResult of result.value) {
+            if (fileResult.status === 'rejected')
+                continue;
+            const { session, filePath, id } = fileResult.value;
+            if (id && session?.sessionId && session.header && !seen.has(id)) {
+                seen.set(id, sessionToSummary(session, id, filePath));
+            }
+        }
+    }
+    const sessions = Array.from(seen.values());
+    sessions.sort((a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime());
+    console.error('[getSessions] Returning', sessions.length, 'sessions');
+    setCache(sessionsCache, key, sessions);
+    return sessions;
+}
+export async function getSessionDetail(dirs, id) {
+    const cacheKeyStr = `${id}:${cacheKey(dirs)}`;
+    const cached = getCached(detailCache, cacheKeyStr);
+    if (cached)
+        return cached;
+    // Try all directories in parallel
+    const results = await Promise.allSettled(dirs.map(async (dir) => {
+        const filePath = path.resolve(dir, `${id}.json`);
+        if (!filePath.startsWith(path.resolve(dir) + path.sep))
+            return null;
+        return readSessionFile(filePath);
+    }));
+    for (const result of results) {
+        if (result.status === 'rejected')
+            continue;
+        const session = result.value;
+        if (session?.sessionId && session.header) {
+            const detail = sessionToDetail(session, id);
+            setCache(detailCache, cacheKeyStr, detail);
+            return detail;
+        }
+    }
+    return null;
+}

package/server/dist/services/cloudError.js

@@ -0,0 +1,15 @@
+// 云端存储统一错误类型：携带 HTTP 状态码，供 AGC 凭证解析与存储操作共用。
+export class CloudStorageError extends Error {
+    /** 期望返回给调用方的 HTTP 状态码 */
+    status;
+    /**
+     * 创建云端存储错误。
+     * @param message 错误描述
+     * @param status HTTP 状态码，默认 502（上游网关错误）
+     */
+    constructor(message, status = 502) {
+        super(message);
+        this.name = 'CloudStorageError';
+        this.status = status;
+    }
+}

package/server/dist/services/cloudStorage.js

@@ -0,0 +1,305 @@
+import { CloudStorageError } from './cloudError.js';
+import { resolveAgcCredentials } from './agcCredentials.js';
+// ─── AGC 端点(单点调整区) ────────────────────────────────────
+// 文档: https://developer.huawei.com/consumer/cn/doc/AppGallery-connect-References/storage-restapi-listfile-0000001498518878
+// 站点对照: token 域名 connect-api*.cloud.huawei.com / 存储域名 ops-server-*.agcstorage.link/v0
+const AGC_SITES = {
+    CN: {
+        tokenHost: 'https://connect-api.cloud.huawei.com',
+        storageHost: 'https://ops-server-drcn.agcstorage.link/v0',
+        downloadHost: 'https://agc-storage-drcn.platform.dbankcloud.cn',
+    },
+    DE: {
+        tokenHost: 'https://connect-api-dre.cloud.huawei.com',
+        storageHost: 'https://ops-server-dre.agcstorage.link/v0',
+        // 海外下载域名按 dbankcloud 海外域推导（当前桶为 CN，未实测）
+        downloadHost: 'https://agc-storage-dre.platform.dbankcloud.com',
+    },
+    SG: {
+        tokenHost: 'https://connect-api-dra.cloud.huawei.com',
+        storageHost: 'https://ops-server-dra.agcstorage.link/v0',
+        downloadHost: 'https://agc-storage-dra.platform.dbankcloud.com',
+    },
+    RURU: {
+        tokenHost: 'https://connect-api-drru.cloud.huawei.com',
+        storageHost: 'https://ops-server-drru.agcstorage.link/v0',
+        downloadHost: 'https://agc-storage-drru.platform.dbankcloud.com',
+    },
+};
+// ─── Access Token(缓存,过期前 60 秒刷新) ───────────────────
+let cachedToken = null;
+async function getCloudAccessToken(cred) {
+    if (cachedToken && Date.now() < cachedToken.expiresAt)
+        return cachedToken.token;
+    const site = resolveSite(cred.region);
+    let res;
+    try {
+        res = await fetch(`${site.tokenHost}/api/oauth2/v1/token`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                grant_type: 'client_credentials',
+                client_id: cred.client_id,
+                client_secret: cred.client_secret,
+            }),
+        });
+    }
+    catch (err) {
+        console.error('AGC token request error:', err);
+        throw new CloudStorageError('Failed to reach AGC token endpoint', 502);
+    }
+    if (!res.ok) {
+        const text = await res.text().catch(() => '');
+        console.error('AGC token request failed:', res.status, text);
+        throw new CloudStorageError(`AGC token request failed (${res.status}): ${text.slice(0, 300)}`, 502);
+    }
+    const data = (await res.json());
+    if (!data.access_token) {
+        throw new CloudStorageError('AGC token response missing access_token', 502);
+    }
+    const expiresInSeconds = Number(data.expires_in) || 172800;
+    cachedToken = { token: data.access_token, expiresAt: Date.now() + (expiresInSeconds - 60) * 1000 };
+    return data.access_token;
+}
+function resolveSite(region) {
+    return AGC_SITES[region] ?? AGC_SITES.CN;
+}
+// ─── 公共请求构造 ────────────────────────────────────────────
+async function buildAgcHeaders(cred) {
+    const token = await getCloudAccessToken(cred);
+    return {
+        client_id: cred.client_id,
+        productId: cred.project_id,
+        Authorization: `Bearer ${token}`,
+        'Content-Type': 'application/json',
+    };
+}
+async function resolveContext() {
+    const cred = await resolveAgcCredentials();
+    const site = resolveSite(cred.region);
+    const headers = await buildAgcHeaders(cred);
+    return { cred, storageHost: site.storageHost, downloadHost: site.downloadHost, headers };
+}
+// 对象路径逐段 encodeURIComponent(见文档「通用注意事项」)
+function encodeObjectKey(key) {
+    return key.split('/').map(encodeURIComponent).join('/');
+}
+function buildObjectUrl(storageHost, bucketName, key, query) {
+    const base = `${storageHost}/${encodeURIComponent(bucketName)}/${encodeObjectKey(key)}`;
+    return query ? `${base}?${query}` : base;
+}
+async function agcFetch(url, init, action) {
+    let res;
+    try {
+        res = await fetch(url, init);
+    }
+    catch (err) {
+        console.error(`AGC ${action} request error:`, err);
+        throw new CloudStorageError(`Failed to reach AGC storage endpoint (${action})`, 502);
+    }
+    if (!res.ok) {
+        const text = await res.text().catch(() => '');
+        console.error(`AGC ${action} failed:`, res.status, text);
+        throw new CloudStorageError(`AGC ${action} failed (${res.status}): ${text.slice(0, 300)}`, 502);
+    }
+    return res;
+}
+// ─── 列举文件 ─────────────────────────────────────────────────
+/** AGC listFiles 响应 → 稳定的 CloudFileListResult(size 字符串转数字) */
+function normalizeListResponse(data) {
+    const obj = (data ?? {});
+    const files = Array.isArray(obj.contents)
+        ? obj.contents
+            .map((f) => ({
+            name: String(f.key ?? ''),
+            size: Number(f.size ?? 0),
+            contentType: String(f.contentType ?? ''),
+            lastModified: String(f.lastModified ?? ''),
+        }))
+            .filter((f) => f.name)
+        : [];
+    const folders = Array.isArray(obj.commonPrefixes)
+        ? obj.commonPrefixes
+            .map((p) => {
+            const prefix = String(p.prefix ?? '');
+            const trimmed = prefix.endsWith('/') ? prefix.slice(0, -1) : prefix;
+            const name = trimmed.split('/').pop() || trimmed;
+            return { prefix, name };
+        })
+            .filter((f) => f.name)
+        : [];
+    return {
+        folders,
+        files,
+        nextMarker: obj.isTruncated && obj.nextMarker ? String(obj.nextMarker) : null,
+    };
+}
+export async function listCloudFiles(options = {}) {
+    const { prefix = '', marker, limit = 100, delimiter = false } = options;
+    const { cred, storageHost, headers } = await resolveContext();
+    const url = new URL(`${storageHost}/${encodeURIComponent(cred.bucket_name)}`);
+    if (prefix)
+        url.searchParams.set('prefix', prefix);
+    if (marker)
+        url.searchParams.set('marker', marker);
+    url.searchParams.set('max-keys', String(limit));
+    if (delimiter)
+        url.searchParams.set('delimiter', '/');
+    const res = await agcFetch(url, { headers }, 'listFiles');
+    try {
+        return normalizeListResponse(JSON.parse(await res.text()));
+    }
+    catch (err) {
+        console.error('AGC listFiles response parse error:', err);
+        throw new CloudStorageError('Failed to parse AGC listFiles response', 502);
+    }
+}
+/**
+ * 拉取指定前缀下的全部对象（自动翻页，无 delimiter）。
+ * 供模糊查询与文件夹递归删除使用；桶内对象量级 1 万以内。
+ * @param prefix 前缀（可选，空为整桶）
+ * @param maxPages 翻页上限保护（默认 50 页 = 5 万对象，超出抛 400）
+ * @returns 全部对象列表（key/size/contentType/lastModified）
+ */
+export async function listAllCloudFiles(prefix = '', maxPages = 50) {
+    const files = [];
+    let marker;
+    for (let page = 0; page < maxPages; page++) {
+        const result = await listCloudFiles({ prefix, marker, limit: 1000, delimiter: false });
+        files.push(...result.files);
+        if (!result.nextMarker)
+            return files;
+        marker = result.nextMarker;
+    }
+    throw new CloudStorageError(`对象数超过翻页上限（${maxPages * 1000}），请缩小前缀范围`, 400);
+}
+export async function downloadCloudFile(key) {
+    const { cred, storageHost, headers } = await resolveContext();
+    const url = buildObjectUrl(storageHost, cred.bucket_name, key);
+    const res = await agcFetch(url, { headers }, 'downloadFile');
+    return {
+        body: res.body,
+        contentType: res.headers.get('content-type') || 'application/octet-stream',
+        contentLength: res.headers.get('content-length'),
+        filename: key.split('/').pop() || 'file',
+    };
+}
+// ─── 下载令牌 ─────────────────────────────────────────────────
+/**
+ * 生成对象下载令牌并组装公网下载 URL（免鉴权，效期以 AGC 官方为准）。
+ * 底层为 ops-server `?token=create`，同对象重复生成返回相同令牌（幂等，已实测）。
+ * URL 格式与 AGC 控制台「复制下载令牌」一致：下载域名/v0/{bucket}/{encodeURIComponent(key)}?token=...
+ */
+export async function getCloudFileDownloadToken(key) {
+    const { cred, storageHost, downloadHost, headers } = await resolveContext();
+    const url = buildObjectUrl(storageHost, cred.bucket_name, key, 'token=create');
+    const res = await agcFetch(url, { headers }, 'createToken');
+    const data = (await res.json().catch(() => null));
+    const token = Array.isArray(data) ? String(data[0] ?? '') : '';
+    if (!token) {
+        throw new CloudStorageError('AGC createToken returned empty token', 502);
+    }
+    const downloadUrl = `${downloadHost}/v0/${encodeURIComponent(cred.bucket_name)}/${encodeURIComponent(key)}?token=${token}`;
+    return { token, url: downloadUrl };
+}
+// ─── 删除文件 ─────────────────────────────────────────────────
+export async function deleteCloudFile(key) {
+    const { cred, storageHost, headers } = await resolveContext();
+    const url = buildObjectUrl(storageHost, cred.bucket_name, key);
+    await agcFetch(url, { method: 'DELETE', headers }, 'deleteFile');
+}
+// ─── 上传 / 重命名 ───────────────────────────────────────────
+export async function cloudFileExists(key) {
+    const { cred, storageHost, headers } = await resolveContext();
+    const url = buildObjectUrl(storageHost, cred.bucket_name, key, 'metadata=query');
+    try {
+        const res = await fetch(url, { headers });
+        return res.ok;
+    }
+    catch {
+        return false;
+    }
+}
+export async function uploadCloudFile(key, content, contentType) {
+    const { cred, storageHost, headers } = await resolveContext();
+    const url = buildObjectUrl(storageHost, cred.bucket_name, key);
+    await agcFetch(url, {
+        method: 'PUT',
+        headers: {
+            ...headers,
+            'X-Agc-Content-Type': contentType || 'application/octet-stream',
+        },
+        body: new Uint8Array(content),
+    }, 'uploadFile');
+}
+export async function renameCloudFile(oldKey, newKey) {
+    const { cred, storageHost, headers } = await resolveContext();
+    const sourceUrl = buildObjectUrl(storageHost, cred.bucket_name, oldKey);
+    const res = await agcFetch(sourceUrl, { headers }, 'downloadFile');
+    const content = Buffer.from(await res.arrayBuffer());
+    const contentType = res.headers.get('content-type') || 'application/octet-stream';
+    await uploadCloudFile(newKey, content, contentType);
+    await deleteCloudFile(oldKey);
+}
+// ─── 文件元数据 ──────────────────────────────────────────────
+function normalizeMetadata(data) {
+    const obj = (data ?? {});
+    const custom = (obj.metadata ?? {});
+    const customMetadata = {};
+    for (const [k, v] of Object.entries(custom)) {
+        customMetadata[k] = String(v);
+    }
+    return {
+        name: String(obj.name ?? ''),
+        bucket: obj.bucket ? String(obj.bucket) : undefined,
+        contentType: obj.contentType ? String(obj.contentType) : undefined,
+        contentDisposition: obj.contentDisposition ? String(obj.contentDisposition) : undefined,
+        contentEncoding: obj.contentEncoding ? String(obj.contentEncoding) : undefined,
+        cacheControl: obj.cacheControl ? String(obj.cacheControl) : undefined,
+        contentLanguage: obj.contentLanguage ? String(obj.contentLanguage) : undefined,
+        size: obj.size != null ? Number(obj.size) : undefined,
+        createTime: obj.createTime ? String(obj.createTime) : undefined,
+        updateTime: obj.updateTime ? String(obj.updateTime) : undefined,
+        storageType: obj.storageType ? String(obj.storageType) : undefined,
+        customMetadata,
+    };
+}
+export async function getCloudFileMetadata(key) {
+    const { cred, storageHost, headers } = await resolveContext();
+    const url = buildObjectUrl(storageHost, cred.bucket_name, key, 'metadata=query');
+    const res = await agcFetch(url, { headers }, 'getMetadata');
+    try {
+        return normalizeMetadata(JSON.parse(await res.text()));
+    }
+    catch (err) {
+        console.error('AGC getMetadata response parse error:', err);
+        throw new CloudStorageError('Failed to parse AGC metadata response', 502);
+    }
+}
+export async function updateCloudFileMetadata(key, update) {
+    const { cred, storageHost, headers } = await resolveContext();
+    const url = buildObjectUrl(storageHost, cred.bucket_name, key, 'metadata=update');
+    const metaHeaders = { ...headers };
+    if (update.contentType)
+        metaHeaders['X-Agc-Content-Type'] = update.contentType;
+    if (update.contentDisposition)
+        metaHeaders['X-Agc-Content-Disposition'] = update.contentDisposition;
+    if (update.contentEncoding)
+        metaHeaders['X-Agc-Content-Encoding'] = update.contentEncoding;
+    if (update.cacheControl)
+        metaHeaders['X-Agc-Cache-Control'] = update.cacheControl;
+    if (update.contentLanguage)
+        metaHeaders['X-Agc-Content-Language'] = update.contentLanguage;
+    for (const [k, v] of Object.entries(update.customMetadata ?? {})) {
+        if (k)
+            metaHeaders[`X-Agc-meta-${k}`] = String(v);
+    }
+    const res = await agcFetch(url, { method: 'GET', headers: metaHeaders }, 'updateMetadata');
+    try {
+        return normalizeMetadata(JSON.parse(await res.text()));
+    }
+    catch (err) {
+        console.error('AGC updateMetadata response parse error:', err);
+        throw new CloudStorageError('Failed to parse AGC updateMetadata response', 502);
+    }
+}

package/server/dist/services/config.js

@@ -0,0 +1,47 @@
+import fs from 'fs/promises';
+import path from 'path';
+import { fileURLToPath } from 'url';
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const DATA_DIR = path.join(__dirname, '..', '..', 'data');
+const CONFIG_FILE = path.join(DATA_DIR, 'config.json');
+const DEFAULT_CONFIG = {
+    favorites: [],
+    customDirs: [],
+};
+let cachedConfig = null;
+export async function ensureDataDir() {
+    await fs.mkdir(DATA_DIR, { recursive: true });
+}
+export async function getConfig() {
+    if (cachedConfig)
+        return cachedConfig;
+    try {
+        const raw = await fs.readFile(CONFIG_FILE, 'utf-8');
+        const parsed = JSON.parse(raw);
+        cachedConfig = {
+            favorites: Array.isArray(parsed.favorites) ? parsed.favorites : [],
+            customDirs: Array.isArray(parsed.customDirs) ? parsed.customDirs : [],
+        };
+    }
+    catch {
+        cachedConfig = { ...DEFAULT_CONFIG };
+    }
+    return cachedConfig;
+}
+export async function saveConfig(config) {
+    await ensureDataDir();
+    await fs.writeFile(CONFIG_FILE, JSON.stringify(config, null, 2), 'utf-8');
+    cachedConfig = config;
+}
+export async function toggleFavorite(sessionId) {
+    const config = await getConfig();
+    const index = config.favorites.indexOf(sessionId);
+    if (index >= 0) {
+        config.favorites.splice(index, 1);
+    }
+    else {
+        config.favorites.push(sessionId);
+    }
+    await saveConfig(config);
+    return config.favorites;
+}

package/server/dist/types/cloud.js

@@ -0,0 +1 @@
+export {};

package/server/dist/types/index.js

@@ -0,0 +1,2 @@
+export * from './session.js';
+export * from './cloud.js';

package/server/dist/types/session.js

@@ -0,0 +1 @@
+export {};