@tablestore/tablestore-agent-cli 0.2.11 → 0.4.0

package/dist/dashboard-runtime/node_modules/@tablestore/agent-storage/README.md

@@ -0,0 +1,203 @@
+# Tablestore Agent Storage TypeScript SDK
+
+This package contains the TypeScript SDK for Tablestore agent storage, including knowledge-base and memory APIs.
+
+## Entrypoints
+
+- `src/index.ts`: cross-runtime core client
+- `src/node.ts`: Node-only client with local file upload support
+
+## Usage
+
+ES modules:
+
+```ts
+import { AgentStorageClient } from '@tablestore/agent-storage';
+
+const client = new AgentStorageClient({
+  endpoint: 'https://your-instance.cn-beijing.ots.aliyuncs.com',
+  instanceName: 'your-instance',
+  accessKeyId: process.env.OTS_ACCESS_KEY_ID!,
+  accessKeySecret: process.env.OTS_ACCESS_KEY_SECRET!,
+});
+```
+
+```ts
+import { NodeAgentStorageClient } from '@tablestore/agent-storage/node';
+
+const client = new NodeAgentStorageClient({
+  endpoint: 'https://your-instance.cn-beijing.ots.aliyuncs.com',
+  instanceName: 'your-instance',
+  accessKeyId: process.env.OTS_ACCESS_KEY_ID!,
+  accessKeySecret: process.env.OTS_ACCESS_KEY_SECRET!,
+  ossEndpoint: 'https://oss-cn-beijing.aliyuncs.com',
+  ossBucketName: 'tantan-source',
+});
+```
+
+CommonJS:
+
+```js
+const { AgentStorageClient } = require('@tablestore/agent-storage');
+const { NodeAgentStorageClient } = require('@tablestore/agent-storage/node');
+```
+
+## Signatures
+
+- default: `v2`
+- optional: `v4` with `region`
+
+## Input Modes
+
+All APIs accept:
+
+- plain JSON requests
+- model instances with `toJSONRequest()`
+
+## API Surface
+
+- `AgentStorageClient`: cross-runtime client for knowledge-base and memory APIs
+- `NodeAgentStorageClient`: Node client that adds OSS-backed document upload
+
+Memory APIs include:
+
+- memory store lifecycle: `createMemoryStore`, `getMemoryStore`, `listMemoryStores`, `updateMemoryStore`, `deleteMemoryStore`
+- memory CRUD/search: `addMemories`, `searchMemories`, `listMemories`, `getMemory`, `updateMemory`, `deleteMemory`
+- audit/message queries: `listMemoryStoreMessages`, `listMemoryStoreRequests`
+- ingest task tracking: `getMemoryTask`, `listMemoryTasks`
+- scope discovery: `listMemoryStoreScopes`
+- memory dream tasks: `createMemoryDreamTask`, `getMemoryDreamTask`, `listMemoryDreamTasks`, `cancelMemoryDreamTask`
+- memory dream actions: `listMemoryDreamActions`, `applyMemoryDreamActions`
+- items (file memory): `addItem`, `listItems`, `getItem`, `updateItem`, `deleteItem`, `listItemVersions`, `getItemVersion`, `redactItemVersion`
+
+## Storage modes
+
+A memory store's `storageMode` is chosen at `createMemoryStore` time and cannot
+be changed afterwards:
+
+- `ots` (default): structured memory only. Item APIs are rejected with `400`.
+- `filemem`: writable, versioned memory files, reached through the item APIs.
+- `file+ots`: structured memory plus a **read-only** projected file tree. Item
+  reads work, item writes return `409 READ_ONLY_STORE`, and the version APIs
+  return `400`.
+
+```ts
+await client.createMemoryStore({
+  memoryStoreName: 'agent_memory',
+  storageMode: 'filemem',
+  // description is capped at 1024 bytes; extractInstructions at 4096 runes
+  extractInstructions: '只抽取与订单相关的事实',
+});
+```
+
+`updateMemoryStore` is a strict PATCH and accepts only `description` and
+`extractInstructions`. Omitting a field leaves it unchanged; sending `''`
+clears it.
+
+`listMemoryStores` returns only `memoryStoreName` per entry — call
+`getMemoryStore` per store to read `storageMode`, `description` or
+`extractInstructions`.
+
+## Items (file memory)
+
+All eight item actions carry `"type": "memoryfile"`, which the SDK fills in
+automatically. `addItem`, `getItem`, `updateItem`, exact `deleteItem`,
+`getItemVersion`, and `redactItemVersion` require a **fully specified
+four-part scope**. Only `listItems`, `listItemVersions`, and ranged
+`deleteItem` accept the left-prefix `*` wildcard: `appId` and `tenantId` stay
+exact, and once a segment is `*` every segment after it must be `*` too.
+
+```ts
+const scoped = {
+  memoryStoreName: 'agent_memory',
+  scope: { appId: 'a', tenantId: 't', agentId: 'ag', runId: 'r' },
+};
+
+await client.addItem({ ...scoped, path: '/notes/a.md', content: 'hello' });
+
+// Get and exact delete require exactly one address: itemId or path.
+// view defaults to 'basic' (metadata only); use 'full' for content.
+const item = await client.getItem({ ...scoped, path: '/notes/a.md', view: 'full' });
+
+// Update requires itemId plus content, a target path, or both.
+const updated = await client.updateItem({
+  ...scoped,
+  itemId: item.itemId,
+  content: 'updated',
+  path: '/notes/b.md', // Target path; itemId is the source address.
+  precondition: { expectedVersionId: item.latestVersionId },
+  view: 'full',
+});
+
+await client.deleteItem({
+  ...scoped,
+  itemId: updated.itemId,
+  precondition: { expectedVersionId: updated.latestVersionId },
+});
+
+const listed = await client.listItems({ ...scoped, pathPrefix: '/notes/', depth: 1 });
+// listed.readOnly is true only for file+ots projections; omitted otherwise.
+// depth: 1 rolls deeper directories up into entries typed 'memoryfile_prefix'.
+
+// Ranged delete: wildcard scope and no itemId/path/precondition. The service
+// immediately returns HTTP 200 with { type, taskId, status: 'pending' }.
+const task = await client.deleteItem({
+  memoryStoreName: 'agent_memory',
+  scope: { appId: 'a', tenantId: 't', agentId: '*', runId: '*' },
+  pathPrefix: '/notes/',
+});
+```
+
+Service-enforced limits: content ≤ 100 KiB (`413 PAYLOAD_TOO_LARGE`), path
+≤ 1024 bytes, `limit` defaults to 20 with a maximum of 100 (capped at 20
+when `view: 'full'`). Paths must start with `/` (no longer auto-added), be
+valid UTF-8, and reject `.`/`..`/empty segments. Every item/version response
+echoes its `scope`, items carry a `latestVersionId` head pointer, and version
+attribution uses typed actors (`createdBy` / `redactedBy` objects with
+`actorType` and `actorId`).
+
+Versions are addressed by the self-contained `versionId` alone —
+`getItemVersion` and `redactItemVersion` take no `itemId`/`versionSeq`.
+`listItemVersions` is scope-level: besides `itemId` it supports `sessionId`,
+`apiKeyId`, `createdAtGte`/`createdAtLte` (RFC3339) and `operation` filters.
+
+`redactItemVersion` irreversibly clears one historical version's content and
+path. It is idempotent and first-wins; afterwards `getItemVersion` still
+returns `200` for that version but never its content.
+
+## Dream tasks
+
+`taskType` defaults to `memory`. Use `skill` or `profile` to emit extracts
+instead of memory mutations — those task types reject `applyMode` with a `400`,
+and their `EMIT_SKILL` / `EMIT_PROFILE` actions cannot be applied.
+
+`listMemoryDreamActions` has two mutually exclusive modes: pass `dreamId` to
+list one run's actions, or pass `scope` plus `actionType`
+(`EMIT_SKILL` / `EMIT_PROFILE`) to list emitted extracts across runs. Sending
+both or neither is a `400`.
+
+Dream `minTimestamp` / `maxTimestamp` accept **Unix milliseconds only**;
+`listMemoryStoreMessages` and `listMemoryStoreRequests` additionally accept
+RFC3339.
+
+## Tests
+
+Run unit tests:
+
+```bash
+npm run test:unit
+```
+
+Run e2e tests:
+
+```bash
+OTS_ENDPOINT=https://your-instance.cn-beijing.ots.aliyuncs.com \
+OTS_ACCESS_KEY_ID=your-ak \
+OTS_ACCESS_KEY_SECRET=your-sk \
+OTS_INSTANCE_NAME=your-instance \
+OTS_REGION=cn-beijing \
+OTS_SIGN_VERSION=v2 \
+OSS_ENDPOINT=https://oss-cn-beijing.aliyuncs.com \
+OSS_BUCKET_NAME=tantan-source \
+npm run test:e2e
+```

package/dist/dashboard-runtime/node_modules/@tablestore/agent-storage/dist/cjs/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}

package/dist/dashboard-runtime/node_modules/@tablestore/agent-storage/dist/cjs/src/core/auth/request-context.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RequestContext = void 0;
+class RequestContext {
+    #credentials;
+    #signDate;
+    constructor(credentials, signDate) {
+        this.#credentials = credentials;
+        this.#signDate = signDate;
+    }
+    getCredentials() {
+        return this.#credentials;
+    }
+    getSignDate() {
+        return this.#signDate;
+    }
+    setSignDate(signDate) {
+        this.#signDate = signDate;
+    }
+}
+exports.RequestContext = RequestContext;

package/dist/dashboard-runtime/node_modules/@tablestore/agent-storage/dist/cjs/src/core/auth/sign-base.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SignBase = void 0;
+exports.hmacSha1Base64 = hmacSha1Base64;
+exports.hmacSha256Base64 = hmacSha256Base64;
+exports.sortAndEncodeQuery = sortAndEncodeQuery;
+const node_crypto_1 = require("node:crypto");
+const client_error_js_1 = require("../errors/client-error.js");
+const OTS_HEADER_PREFIX = 'x-ots-';
+function hmacSha1Base64(signingKey, content) {
+    return (0, node_crypto_1.createHmac)('sha1', signingKey).update(content, 'utf8').digest('base64');
+}
+function hmacSha256Base64(signingKey, content) {
+    return (0, node_crypto_1.createHmac)('sha256', signingKey).update(content, 'utf8').digest('base64');
+}
+function sortAndEncodeQuery(queryString) {
+    if (!queryString) {
+        return '';
+    }
+    const pairs = [...new URLSearchParams(queryString).entries()].sort(([leftKey, leftValue], [rightKey, rightValue]) => {
+        const keyComparison = leftKey.localeCompare(rightKey);
+        if (keyComparison !== 0) {
+            return keyComparison;
+        }
+        return leftValue.localeCompare(rightValue);
+    });
+    return new URLSearchParams(pairs).toString();
+}
+function splitQuery(query) {
+    const hashIndex = query.indexOf('#');
+    const hashStripped = hashIndex >= 0 ? query.slice(0, hashIndex) : query;
+    const queryIndex = hashStripped.indexOf('?');
+    if (queryIndex < 0) {
+        return {
+            uri: hashStripped,
+            queryString: '',
+        };
+    }
+    return {
+        uri: hashStripped.slice(0, queryIndex),
+        queryString: hashStripped.slice(queryIndex + 1),
+    };
+}
+class SignBase {
+    makeHeadersString(headers) {
+        const headerItems = Object.entries(headers)
+            .filter(([key]) => key.toLowerCase().startsWith(OTS_HEADER_PREFIX))
+            .map(([key, value]) => `${key.toLowerCase()}:${value.trim()}`)
+            .sort();
+        return headerItems.join('\n');
+    }
+    getRequestSignatureString(query, headers) {
+        const { uri, queryString } = splitQuery(query);
+        const sortedQuery = sortAndEncodeQuery(queryString);
+        const headersString = this.makeHeadersString(headers);
+        return `${uri}\nPOST\n${sortedQuery}\n${headersString}\n`;
+    }
+    makeResponseSignature(query, headers, signingKey) {
+        const { uri } = splitQuery(query);
+        const headersString = this.makeHeadersString(headers);
+        return hmacSha1Base64(signingKey, `${headersString}\n${uri}`);
+    }
+    requireSignDate(signDate) {
+        if (!signDate) {
+            throw new client_error_js_1.OTSClientError('v4 sign_date is None.');
+        }
+        return signDate;
+    }
+}
+exports.SignBase = SignBase;

package/dist/dashboard-runtime/node_modules/@tablestore/agent-storage/dist/cjs/src/core/auth/sign-v2.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SignV2 = void 0;
+const sign_base_js_1 = require("./sign-base.js");
+class SignV2 extends sign_base_js_1.SignBase {
+    getSigningKey(requestContext) {
+        return requestContext.getCredentials().accessKeySecret;
+    }
+    makeRequestSignatureAndAddHeaders(query, headers, requestContext) {
+        headers['x-ots-signature'] = (0, sign_base_js_1.hmacSha1Base64)(this.getSigningKey(requestContext), this.getRequestSignatureString(query, headers));
+    }
+}
+exports.SignV2 = SignV2;

package/dist/dashboard-runtime/node_modules/@tablestore/agent-storage/dist/cjs/src/core/auth/sign-v4.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SignV4 = void 0;
+const node_crypto_1 = require("node:crypto");
+const client_error_js_1 = require("../errors/client-error.js");
+const sign_base_js_1 = require("./sign-base.js");
+const V4_SIGNATURE_PRODUCT = 'ots';
+const V4_SIGNATURE_SEED = 'aliyun';
+const V4_SIGNATURE_PREFIX = `${V4_SIGNATURE_SEED}_v4`;
+const V4_SIGNATURE_CONSTANT = `${V4_SIGNATURE_SEED}_v4_request`;
+const V4_SIGNATURE_SALT = 'ots';
+function hmacSha256Bytes(signingKey, content) {
+    return (0, node_crypto_1.createHmac)('sha256', signingKey).update(content, 'utf8').digest();
+}
+class SignV4 extends sign_base_js_1.SignBase {
+    signRegion;
+    signDate;
+    autoUpdateV4Sign;
+    constructor(options) {
+        super();
+        if (!options.region) {
+            throw new client_error_js_1.OTSClientError('region is not str or is empty.');
+        }
+        this.signRegion = options.region;
+        this.signDate = options.signDate;
+        this.autoUpdateV4Sign = options.autoUpdateV4Sign ?? options.signDate === undefined;
+    }
+    getAndSetV4SignDate(requestContext) {
+        const currentDate = this.autoUpdateV4Sign
+            ? new Date().toISOString().slice(0, 10).replaceAll('-', '')
+            : this.signDate;
+        const signDate = this.requireSignDate(currentDate);
+        requestContext.setSignDate(signDate);
+        return signDate;
+    }
+    getSigningKey(requestContext) {
+        const accessKeySecret = requestContext.getCredentials().accessKeySecret;
+        const signDate = this.requireSignDate(requestContext.getSignDate());
+        const first = hmacSha256Bytes(`${V4_SIGNATURE_PREFIX}${accessKeySecret}`, signDate);
+        const second = hmacSha256Bytes(first, this.signRegion);
+        const third = hmacSha256Bytes(second, V4_SIGNATURE_PRODUCT);
+        const fourth = hmacSha256Bytes(third, V4_SIGNATURE_CONSTANT);
+        return Buffer.from(fourth.toString('base64'), 'utf8');
+    }
+    makeRequestSignatureAndAddHeaders(query, headers, requestContext) {
+        headers['x-ots-signdate'] = this.getAndSetV4SignDate(requestContext);
+        headers['x-ots-signregion'] = this.signRegion;
+        headers['x-ots-signaturev4'] = (0, sign_base_js_1.hmacSha256Base64)(this.getSigningKey(requestContext), `${this.getRequestSignatureString(query, headers)}${V4_SIGNATURE_SALT}`);
+    }
+}
+exports.SignV4 = SignV4;

package/dist/dashboard-runtime/node_modules/@tablestore/agent-storage/dist/cjs/src/core/client/agent-storage-client.js

@@ -0,0 +1,196 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentStorageClient = void 0;
+const ots_json_client_js_1 = require("../http/ots-json-client.js");
+const version_js_1 = require("../version.js");
+const file_js_1 = require("../models/file.js");
+const to_json_request_js_1 = require("../serialization/to-json-request.js");
+/**
+ * Normalizes an item request body, filling `type: 'memoryfile'` when the
+ * caller did not provide a non-empty item type.
+ */
+function toItemRequest(request) {
+    const body = ((0, to_json_request_js_1.toJSONRequest)(request ?? {}) ?? {});
+    if (typeof body.type === 'string' && body.type.length > 0) {
+        return body;
+    }
+    const { type: _omitted, ...rest } = body;
+    return { type: file_js_1.ITEM_TYPE_MEMORY_FILE, ...rest };
+}
+class AgentStorageClient {
+    client;
+    constructor(options) {
+        const fetchImpl = options.fetch ?? globalThis.fetch;
+        const userAgent = options.userAgentSuffix
+            ? `${version_js_1.DEFAULT_USER_AGENT} ${options.userAgentSuffix}`
+            : version_js_1.DEFAULT_USER_AGENT;
+        this.client = new ots_json_client_js_1.OTSJSONClient({
+            endpoint: options.endpoint,
+            instanceName: options.instanceName,
+            credentials: options.accessKeyId && options.accessKeySecret
+                ? {
+                    accessKeyId: options.accessKeyId,
+                    accessKeySecret: options.accessKeySecret,
+                    securityToken: options.stsToken,
+                }
+                : undefined,
+            apiKey: options.apiKey,
+            signVersion: options.signVersion ?? 'v2',
+            region: options.region,
+            fetch: fetchImpl,
+            userAgent,
+            extraHeaders: options.extraHeaders,
+        });
+    }
+    createKnowledgeBase(request) {
+        return this.client.request('CreateKnowledgeBase', (0, to_json_request_js_1.toJSONRequest)(request));
+    }
+    deleteKnowledgeBase(request) {
+        return this.client.request('DeleteKnowledgeBase', (0, to_json_request_js_1.toJSONRequest)(request));
+    }
+    describeKnowledgeBase(request) {
+        return this.client.request('DescribeKnowledgeBase', (0, to_json_request_js_1.toJSONRequest)(request));
+    }
+    listKnowledgeBase(request = {}) {
+        return this.client.request('ListKnowledgeBase', (0, to_json_request_js_1.toJSONRequest)(request));
+    }
+    updateKnowledgeBase(request) {
+        return this.client.request('UpdateKnowledgeBase', (0, to_json_request_js_1.toJSONRequest)(request));
+    }
+    addDocuments(request) {
+        return this.client.request('AddDocuments', (0, to_json_request_js_1.toJSONRequest)(request));
+    }
+    updateDocument(request) {
+        return this.client.request('UpdateDocument', (0, to_json_request_js_1.toJSONRequest)(request));
+    }
+    getDocument(request) {
+        return this.client.request('GetDocument', (0, to_json_request_js_1.toJSONRequest)(request));
+    }
+    listDocuments(request) {
+        return this.client.request('ListDocuments', (0, to_json_request_js_1.toJSONRequest)(request));
+    }
+    deleteDocuments(request) {
+        return this.client.request('DeleteDocuments', (0, to_json_request_js_1.toJSONRequest)(request));
+    }
+    retrieve(request) {
+        return this.client.request('Retrieve', (0, to_json_request_js_1.toJSONRequest)(request));
+    }
+    listChunks(request) {
+        return this.client.request('ListChunks', (0, to_json_request_js_1.toJSONRequest)(request));
+    }
+    updateChunks(request) {
+        return this.client.request('UpdateChunks', (0, to_json_request_js_1.toJSONRequest)(request));
+    }
+    createMemoryStore(request) {
+        return this.client.request('CreateMemoryStore', (0, to_json_request_js_1.toJSONRequest)(request));
+    }
+    getMemoryStore(request) {
+        return this.client.request('GetMemoryStore', (0, to_json_request_js_1.toJSONRequest)(request));
+    }
+    listMemoryStores(request = {}) {
+        return this.client.request('ListMemoryStores', (0, to_json_request_js_1.toJSONRequest)(request));
+    }
+    updateMemoryStore(request) {
+        return this.client.request('UpdateMemoryStore', (0, to_json_request_js_1.toJSONRequest)(request));
+    }
+    deleteMemoryStore(request) {
+        return this.client.request('DeleteMemoryStore', (0, to_json_request_js_1.toJSONRequest)(request));
+    }
+    addMemories(request) {
+        return this.client.request('AddMemories', (0, to_json_request_js_1.toJSONRequest)(request));
+    }
+    searchMemories(request) {
+        return this.client.request('SearchMemories', (0, to_json_request_js_1.toJSONRequest)(request));
+    }
+    listMemories(request) {
+        return this.client.request('ListMemories', (0, to_json_request_js_1.toJSONRequest)(request));
+    }
+    getMemory(request) {
+        return this.client.request('GetMemory', (0, to_json_request_js_1.toJSONRequest)(request));
+    }
+    updateMemory(request) {
+        return this.client.request('UpdateMemory', (0, to_json_request_js_1.toJSONRequest)(request));
+    }
+    deleteMemory(request) {
+        return this.client.request('DeleteMemory', (0, to_json_request_js_1.toJSONRequest)(request));
+    }
+    listMemoryStoreMessages(request) {
+        return this.client.request('ListMemoryStoreMessages', (0, to_json_request_js_1.toJSONRequest)(request));
+    }
+    listMemoryStoreRequests(request) {
+        return this.client.request('ListMemoryStoreRequests', (0, to_json_request_js_1.toJSONRequest)(request));
+    }
+    getMemoryTask(request) {
+        return this.client.request('GetMemoryTask', (0, to_json_request_js_1.toJSONRequest)(request));
+    }
+    listMemoryTasks(request) {
+        return this.client.request('ListMemoryTasks', (0, to_json_request_js_1.toJSONRequest)(request));
+    }
+    listMemoryStoreScopes(request) {
+        return this.client.request('ListMemoryStoreScopes', (0, to_json_request_js_1.toJSONRequest)(request));
+    }
+    createMemoryDreamTask(request) {
+        return this.client.request('CreateMemoryDreamTask', (0, to_json_request_js_1.toJSONRequest)(request));
+    }
+    getMemoryDreamTask(request) {
+        return this.client.request('GetMemoryDreamTask', (0, to_json_request_js_1.toJSONRequest)(request));
+    }
+    listMemoryDreamTasks(request) {
+        return this.client.request('ListMemoryDreamTasks', (0, to_json_request_js_1.toJSONRequest)(request));
+    }
+    cancelMemoryDreamTask(request) {
+        return this.client.request('CancelMemoryDreamTask', (0, to_json_request_js_1.toJSONRequest)(request));
+    }
+    listMemoryDreamActions(request) {
+        return this.client.request('ListMemoryDreamActions', (0, to_json_request_js_1.toJSONRequest)(request));
+    }
+    applyMemoryDreamActions(request) {
+        return this.client.request('ApplyMemoryDreamActions', (0, to_json_request_js_1.toJSONRequest)(request));
+    }
+    getWiki(request) {
+        return this.client.request('GetWiki', (0, to_json_request_js_1.toJSONRequest)(request));
+    }
+    updateWiki(request) {
+        return this.client.request('UpdateWiki', (0, to_json_request_js_1.toJSONRequest)(request));
+    }
+    ingestWiki(request) {
+        return this.client.request('IngestWiki', (0, to_json_request_js_1.toJSONRequest)(request));
+    }
+    listWikiPages(request) {
+        return this.client.request('ListWikiPages', (0, to_json_request_js_1.toJSONRequest)(request));
+    }
+    getWikiPage(request) {
+        return this.client.request('GetWikiPage', (0, to_json_request_js_1.toJSONRequest)(request));
+    }
+    searchWikiPages(request) {
+        return this.client.request('SearchWikiPages', (0, to_json_request_js_1.toJSONRequest)(request));
+    }
+    addItem(request) {
+        return this.client.request('AddItem', toItemRequest(request));
+    }
+    listItems(request) {
+        return this.client.request('ListItems', toItemRequest(request));
+    }
+    getItem(request) {
+        return this.client.request('GetItem', toItemRequest(request));
+    }
+    updateItem(request) {
+        return this.client.request('UpdateItem', toItemRequest(request));
+    }
+    deleteItem(request) {
+        return this.client.request('DeleteItem', toItemRequest(request));
+    }
+    listItemVersions(request) {
+        return this.client.request('ListItemVersions', toItemRequest(request));
+    }
+    getItemVersion(request) {
+        return this.client.request('GetItemVersion', toItemRequest(request));
+    }
+    redactItemVersion(request) {
+        return this.client.request('RedactItemVersion', toItemRequest(request));
+    }
+    uploadDocuments(_request) {
+        throw new Error('uploadDocuments is only available in the NodeAgentStorageClient.');
+    }
+}
+exports.AgentStorageClient = AgentStorageClient;

package/dist/dashboard-runtime/node_modules/@tablestore/agent-storage/dist/cjs/src/core/errors/client-error.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OTSClientError = void 0;
+class OTSClientError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'OTSClientError';
+    }
+}
+exports.OTSClientError = OTSClientError;

package/dist/dashboard-runtime/node_modules/@tablestore/agent-storage/dist/cjs/src/core/errors/service-error.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OTSServiceError = void 0;
+class OTSServiceError extends Error {
+    statusCode;
+    requestId;
+    code;
+    constructor(message, options) {
+        super(message);
+        this.name = 'OTSServiceError';
+        this.statusCode = options.statusCode;
+        this.requestId = options.requestId;
+        this.code = options.code;
+    }
+}
+exports.OTSServiceError = OTSServiceError;

package/dist/dashboard-runtime/node_modules/@tablestore/agent-storage/dist/cjs/src/core/http/headers.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildDateHeader = buildDateHeader;
+exports.buildRequestHeaders = buildRequestHeaders;
+const md5_js_1 = require("./md5.js");
+const version_js_1 = require("../version.js");
+const API_VERSION = '2015-12-31';
+function buildDateHeader(date = new Date()) {
+    const iso = date.toISOString();
+    return `${iso.slice(0, 19)}.000Z`;
+}
+function buildRequestHeaders(options) {
+    const headers = {
+        'x-ots-date': buildDateHeader(options.date),
+        'x-ots-apiversion': API_VERSION,
+        'x-ots-accesskeyid': options.credentials.accessKeyId,
+        'x-ots-instancename': options.instanceName,
+        'x-ots-contentmd5': (0, md5_js_1.md5Base64)(options.body),
+    };
+    if (options.credentials.securityToken) {
+        headers['x-ots-ststoken'] = options.credentials.securityToken;
+    }
+    if (options.extraHeaders) {
+        for (const [key, value] of Object.entries(options.extraHeaders)) {
+            headers[key] = value;
+        }
+    }
+    options.signer.makeRequestSignatureAndAddHeaders(options.query, headers, options.requestContext);
+    headers['User-Agent'] = options.userAgent ?? version_js_1.DEFAULT_USER_AGENT;
+    return headers;
+}

package/dist/dashboard-runtime/node_modules/@tablestore/agent-storage/dist/cjs/src/core/http/md5.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.md5Base64 = md5Base64;
+const node_crypto_1 = require("node:crypto");
+function md5Base64(content) {
+    const hash = (0, node_crypto_1.createHash)('md5');
+    hash.update(content);
+    return hash.digest('base64');
+}