@tablestore/tablestore-agent-cli 0.2.10 → 0.3.1

package/dist/dashboard-runtime/dashboard/src/app/api/v1/memory/stores/[store]/file-memory/file/route.ts

@@ -1,69 +0,0 @@
-import { type NextRequest } from "next/server";
-
-import {
-  errorResponse,
-  handleApiError,
-  requireClients,
-  successResponse,
-} from "@/lib/server/api-helpers";
-import { readLocalMemoryFile } from "@tablestore/tablestore-agent-sdk";
-
-import { readMountScope, resolveScopeDir } from "../_helpers";
-
-export const runtime = "nodejs";
-export const dynamic = "force-dynamic";
-
-interface RouteContext {
-  params: Promise<{ store: string }>;
-}
-
-/**
- * GET /api/v1/memory/stores/:store/file-memory/file?appId=…&…&path=<rel>
- *
- * 读取本地镜像目录里的单个投影文件。`path` 为 scope 目录内的相对路径；
- * 越界（`..`/绝对路径）回 400，文件不存在回 404。
- */
-export async function GET(request: NextRequest, context: RouteContext) {
-  try {
-    const { store } = await context.params;
-    const auth = requireClients(request);
-    if (!("memory" in auth)) return auth;
-
-    const params = new URL(request.url).searchParams;
-    const scope = readMountScope(params);
-    if (!scope) {
-      return errorResponse("BAD_REQUEST", "appId is required", 400);
-    }
-    const rel = params.get("path") ?? "";
-    if (!rel) {
-      return errorResponse("BAD_REQUEST", "path is required", 400);
-    }
-    const { scopeDir } = resolveScopeDir(
-      auth.config.ots_instance_name ?? "",
-      store,
-      scope,
-    );
-
-    let content: string;
-    try {
-      content = readLocalMemoryFile(scopeDir, rel);
-    } catch (err) {
-      const code = (err as NodeJS.ErrnoException)?.code;
-      if (code === "ENOENT" || code === "EISDIR") {
-        return errorResponse("NOT_FOUND", `memory file not found: ${rel}`, 404);
-      }
-      // 越界路径由 readLocalMemoryFile 抛出无 errno code 的普通 Error → 400 并回传
-      // 受控 message；其余带 code 的系统级错误（EACCES/IO 等）交给 handleApiError
-      // 归为 500，避免误标 400 并泄露含服务器绝对路径的原始错误信息。
-      if (code) throw err;
-      return errorResponse(
-        "BAD_REQUEST",
-        err instanceof Error ? err.message : String(err),
-        400,
-      );
-    }
-    return successResponse({ rel, content });
-  } catch (error) {
-    return handleApiError(error);
-  }
-}

package/dist/dashboard-runtime/dashboard/src/app/api/v1/memory/stores/[store]/file-memory/sync/route.ts

@@ -1,69 +0,0 @@
-import { type NextRequest } from "next/server";
-
-import {
-  errorResponse,
-  handleApiError,
-  requireClients,
-  successResponse,
-} from "@/lib/server/api-helpers";
-import {
-  listLocalMemoryFiles,
-  syncMemoryMount,
-} from "@tablestore/tablestore-agent-sdk";
-
-import { readMountScope, resolveScopeDir } from "../_helpers";
-
-export const runtime = "nodejs";
-export const dynamic = "force-dynamic";
-
-interface RouteContext {
-  params: Promise<{ store: string }>;
-}
-
-/**
- * POST /api/v1/memory/stores/:store/file-memory/sync
- *
- * 把该 scope 的 OSS 文件投影增量同步到本地镜像目录（AuthorizeMemoryMount +
- * STS，凭证只在 server 侧使用，不回传浏览器），返回同步统计与文件树。
- * 同步失败不视为 HTTP 错误——本地旧副本仍可浏览，`sync.ok=false` 携带原因。
- */
-export async function POST(request: NextRequest, context: RouteContext) {
-  try {
-    const { store } = await context.params;
-    const auth = requireClients(request);
-    if (!("memory" in auth)) return auth;
-
-    let body: Record<string, unknown>;
-    try {
-      body = (await request.json()) as Record<string, unknown>;
-    } catch {
-      return errorResponse("BAD_REQUEST", "Request body must be JSON", 400);
-    }
-    const scope = readMountScope(
-      (body?.scope ?? null) as Record<string, unknown> | null,
-    );
-    if (!scope) {
-      return errorResponse("BAD_REQUEST", "scope.appId is required", 400);
-    }
-
-    const { localRoot } = resolveScopeDir(
-      auth.config.ots_instance_name ?? "",
-      store,
-      scope,
-    );
-    const ttlSeconds =
-      typeof body?.ttlSeconds === "number" ? body.ttlSeconds : undefined;
-    const sync = await syncMemoryMount({
-      authorizeMount: (req) => auth.memory.authorizeMemoryMount(req),
-      memoryStoreName: store,
-      scope,
-      localRoot,
-      ...(ttlSeconds ? { ttlSeconds } : {}),
-    });
-    const { scopeDir, ...syncStats } = sync;
-    const files = listLocalMemoryFiles(scopeDir);
-    return successResponse({ scopeDir, sync: syncStats, files });
-  } catch (error) {
-    return handleApiError(error);
-  }
-}

package/dist/dashboard-runtime/dashboard/src/app/api/v1/memory/stores/[store]/file-memory/tree/route.ts

@@ -1,44 +0,0 @@
-import { type NextRequest } from "next/server";
-
-import {
-  errorResponse,
-  handleApiError,
-  requireClients,
-  successResponse,
-} from "@/lib/server/api-helpers";
-import { listLocalMemoryFiles } from "@tablestore/tablestore-agent-sdk";
-
-import { readMountScope, resolveScopeDir } from "../_helpers";
-
-export const runtime = "nodejs";
-export const dynamic = "force-dynamic";
-
-interface RouteContext {
-  params: Promise<{ store: string }>;
-}
-
-/**
- * GET /api/v1/memory/stores/:store/file-memory/tree?appId=…&tenantId=…&agentId=…&runId=…
- *
- * 只读本地镜像目录的文件树，不触发同步、不联网。目录尚不存在时返回空列表。
- */
-export async function GET(request: NextRequest, context: RouteContext) {
-  try {
-    const { store } = await context.params;
-    const auth = requireClients(request);
-    if (!("memory" in auth)) return auth;
-
-    const scope = readMountScope(new URL(request.url).searchParams);
-    if (!scope) {
-      return errorResponse("BAD_REQUEST", "appId is required", 400);
-    }
-    const { scopeDir } = resolveScopeDir(
-      auth.config.ots_instance_name ?? "",
-      store,
-      scope,
-    );
-    return successResponse({ scopeDir, files: listLocalMemoryFiles(scopeDir) });
-  } catch (error) {
-    return handleApiError(error);
-  }
-}

package/dist/dashboard-runtime/node_modules/@tablestore/tablestore-agent-sdk/dist/file-memory.d.ts

@@ -1,153 +0,0 @@
-import type { StandardResponse } from "./types.js";
-export interface MountScope {
-    appId: string;
-    tenantId: string;
-    agentId: string;
-    runId: string;
-}
-export declare function sanitizeScopeSegment(seg: string | undefined | null): string;
-/**
- * 单个 scope 的本地镜像子目录：`<root>/<app>__<tenant>__<agent>__<run>`。
- * 段内 sanitize 可能折叠不同原值（如 `a@b` 与 `a_b`）；真实冲突由服务端
- * OSS prefix 里的 scopehash 兜底，本地目录只求隔离与可读。
- */
-export declare function mountScopeDir(localRoot: string, scope: MountScope): string;
-/**
- * 文件记忆本地镜像目录（sync 写入、tree/cat 读取共用同一规则）：
- * `<localRoot>/<app>/<tenant>` 两层路径。
- *
- * 服务端按 **user** 粒度投影，OSS 前缀在聚合维度上直接省略 agent/run
- * （`mem/{inst}/{store}/{app}/{tenant}/{hash}/memory/`），因此本地镜像也只按
- * app/tenant 两层组织——同一用户的不同智能体/会话共享同一份本地副本，租户之间
- * 相互隔离。段内非 `[A-Za-z0-9._-]` 字符 sanitize，空字段回落 `__default__`。
- *
- * 注：假定服务端 projection_group_level=user（本部署实际值）。
- */
-export declare function fileMemoryScopeDir(localRoot: string, scope: Partial<MountScope>): string;
-/** 通配符/空字段 → `__default__`；显式值原样保留。挂载 scope 禁止通配。 */
-export declare function normalizeMountScope(scope: Partial<MountScope>): MountScope;
-/**
- * dashboard 与 CLI 共享的默认本地根：
- * `<CONFIG_DIR>/file-memory/<otsInstanceName>/<memoryStoreName>`。
- * 两端使用同一约定，dashboard 聊天同步下来的文件 CLI 直接可见。
- */
-export declare function defaultFileMemoryRoot(otsInstanceName: string, memoryStoreName: string): string;
-/**
- * CJK 感知分词：ASCII 词元（≥2 字符，小写）+ CJK 单字 + 连续 bigram，
- * 让短中文查询也能命中。
- */
-export declare function tokenizeQuery(query: string): string[];
-/** 按匹配词元比例打分（0~1），整句命中 +0.1 bonus。 */
-export declare function scoreSnippet(snippetText: string, queryTerms: string[], fullQuery: string): number;
-export interface LocalMemoryHit {
-    unit: {
-        text: string;
-        source: string;
-    };
-    score: number;
-}
-export interface SearchLocalMemoriesResult {
-    results: LocalMemoryHit[];
-    skipped?: boolean;
-}
-/**
- * 只在给定 scope 目录子树内做词法检索：每个文件按 10 行一个 block 切分，
- * 按匹配词元比例打分取 top-K。绝不读取兄弟 scope 目录。
- */
-export declare function searchLocalMemories(opts: {
-    scopeDir: string;
-    query: string;
-    topK: number;
-    minQueryLength?: number;
-}): SearchLocalMemoriesResult;
-export interface LocalMemoryFileEntry {
-    rel: string;
-    size: number;
-    mtimeMs: number;
-}
-/** 稳定排序（按 rel 路径）的 scope 目录文件列表；目录不存在返回空。 */
-export declare function listLocalMemoryFiles(scopeDir: string): LocalMemoryFileEntry[];
-/**
- * 把 `rel` 归一化到 `baseDir` 内的绝对路径，并拒绝越界（`..` / 绝对路径）。
- * 读、写共用同一防穿越逻辑（避免异常对象名把文件写/读到 scope 目录之外）。
- */
-export declare function resolveWithinDir(baseDir: string, rel: string): string;
-/** 读取 scope 目录内单个文件；`rel` 归一化后必须仍在 scopeDir 内（防穿越）。 */
-export declare function readLocalMemoryFile(scopeDir: string, rel: string): string;
-export interface RemoteObjectEntry {
-    rel: string;
-    etag: string;
-}
-export interface SyncPlan {
-    toDownload: string[];
-    toDelete: string[];
-}
-/**
- * 纯 diff：远端 `[{rel, etag}]`（etag = 单次 PutObject 投影的 md5 hex）对比
- * 本地 md5 Map，决定下载（新增/变更）与删除（孤儿）。
- */
-export declare function planSync(remote: RemoteObjectEntry[], localMd5: Map<string, string>, { pruneOrphans }?: {
-    pruneOrphans?: boolean;
-}): SyncPlan;
-interface MountCredentials {
-    accessKeyId?: string;
-    accessKeySecret?: string;
-    securityToken?: string;
-    expiration?: string;
-}
-/** 与 ali-oss 客户端交集的最小只读接口（便于测试注入）。 */
-export interface OssReadClient {
-    list(query: {
-        prefix: string;
-        "max-keys": number;
-        marker?: string;
-    }, options: Record<string, never>): Promise<{
-        objects?: Array<{
-            name?: string;
-            etag?: string;
-        }>;
-        isTruncated?: boolean;
-        nextMarker?: string;
-    }>;
-    get(name: string): Promise<{
-        content: Buffer;
-    }>;
-}
-export type OssReadClientFactory = (target: {
-    ossEndpoint?: string;
-    region?: string;
-    bucket: string;
-}, credentials: Required<Pick<MountCredentials, "accessKeyId" | "accessKeySecret">> & MountCredentials) => Promise<OssReadClient>;
-export interface SyncMemoryMountOptions {
-    /** 通常为 `(req) => memoryClient.authorizeMemoryMount(req)`。 */
-    authorizeMount: (request: Record<string, unknown>) => Promise<StandardResponse>;
-    memoryStoreName: string;
-    scope: MountScope;
-    /** 本地根目录；scope 子目录由 mountScopeDir 派生。 */
-    localRoot: string;
-    ttlSeconds?: number;
-    pruneOrphans?: boolean;
-    /** 仅测试注入用。 */
-    ossClientFactory?: OssReadClientFactory;
-}
-export interface SyncMemoryMountResult {
-    ok: boolean;
-    scopeDir: string;
-    downloaded: number;
-    deleted: number;
-    total: number;
-    error?: string;
-}
-/**
- * 同步一个 scope 的 OSS 投影到本地镜像目录（openclaw syncScopeOnce 同款）：
- * AuthorizeMemoryMount（每次重新签发 STS，不落盘）→ 分页列举 → ETag diff →
- * 原子写下载 + 删孤儿。
- *
- * 失败语义：授权/列举阶段失败时本地副本完全不动（返回 `{ok:false, error}`）；
- * 下载阶段逐文件原子写，若中途某文件失败则中止并返回 `{ok:false}`，此时本地为
- * **部分更新**（已写入的新文件保留、未处理的孤儿未删）——下次同步会按 ETag diff
- * 自愈。
- */
-export declare function syncMemoryMount(opts: SyncMemoryMountOptions): Promise<SyncMemoryMountResult>;
-export {};
-//# sourceMappingURL=file-memory.d.ts.map

package/dist/dashboard-runtime/node_modules/@tablestore/tablestore-agent-sdk/dist/file-memory.d.ts.map

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