agentlink-sdk 1.0.8 → 1.0.9

package/dist/index.d.mts

@@ -120,6 +120,17 @@ declare function verifyWhitelist(serverUrl: string, origin?: string): Promise<bo
  */
 declare function fetchWhitelistInfo(serverUrl: string, includeAll?: boolean): Promise<any>;
 
+/**
+ * GET /api/capabilities 返回的能力描述
+ */
+interface CapabilitiesResponse {
+    structureData: boolean;
+}
+/**
+ * 请求 server 的 GET /api/capabilities，返回当前实例是否提供 structureData 等能力
+ */
+declare function fetchCapabilities(serverUrl: string): Promise<CapabilitiesResponse>;
+
 /**
  * 自动遍历 rawData 推断出体积受控的 schema，供 LLM 使用
  */
@@ -148,6 +159,30 @@ interface InferSchemaOptions {
  */
 declare function inferSchema(rawData: any, options?: InferSchemaOptions): InferredSchema;
 
+/**
+ * POST /api/structureData 返回的结构化结果（与 server AIProcessedData 一致）
+ */
+interface StructureDataResult {
+    source: string;
+    category: string;
+    content: string;
+    tags: string[];
+    images?: string[];
+    metadata?: Record<string, unknown>;
+}
+interface FetchStructureDataOptions {
+    systemPrompt?: string;
+    temperature?: number;
+}
+/**
+ * 从 SSE 响应文本中解析最后一条 result 或 error
+ */
+declare function parseSSEResult(sseText: string): StructureDataResult;
+/**
+ * 请求 server 的 POST /api/structureData，传入 schema，返回结构化结果
+ */
+declare function fetchStructureData(serverUrl: string, schema: InferredSchema, options?: FetchStructureDataOptions): Promise<StructureDataResult>;
+
 /**
  * Base64 数据隔离和替换工具
  * 用于在 LLM 处理前替换 base64 图片数据，减少输入大小
@@ -175,4 +210,4 @@ declare function restoreBase64(data: any, replacements: Map<string, string>): an
  */
 declare function extractImages(data: any): string[];
 
-export { AgentLinkClient, type AgentLinkClientOptions, DEFAULT_SERVER_URL, type InferSchemaOptions, type InferredSchema, type SenderInfo, type URLData, type WhitelistInfo, type WhitelistResponse, base64ToUint8Array, compress, decodeDataFromUrl, decompress, encodeDataToUrl, extractAndReplaceBase64, extractImages, fetchWhitelistInfo, inferSchema, restoreBase64, uint8ArrayToBase64, verifyWhitelist };
+export { AgentLinkClient, type AgentLinkClientOptions, type CapabilitiesResponse, DEFAULT_SERVER_URL, type FetchStructureDataOptions, type InferSchemaOptions, type InferredSchema, type SenderInfo, type StructureDataResult, type URLData, type WhitelistInfo, type WhitelistResponse, base64ToUint8Array, compress, decodeDataFromUrl, decompress, encodeDataToUrl, extractAndReplaceBase64, extractImages, fetchCapabilities, fetchStructureData, fetchWhitelistInfo, inferSchema, parseSSEResult, restoreBase64, uint8ArrayToBase64, verifyWhitelist };

package/dist/index.d.ts

@@ -120,6 +120,17 @@ declare function verifyWhitelist(serverUrl: string, origin?: string): Promise<bo
  */
 declare function fetchWhitelistInfo(serverUrl: string, includeAll?: boolean): Promise<any>;
 
+/**
+ * GET /api/capabilities 返回的能力描述
+ */
+interface CapabilitiesResponse {
+    structureData: boolean;
+}
+/**
+ * 请求 server 的 GET /api/capabilities，返回当前实例是否提供 structureData 等能力
+ */
+declare function fetchCapabilities(serverUrl: string): Promise<CapabilitiesResponse>;
+
 /**
  * 自动遍历 rawData 推断出体积受控的 schema，供 LLM 使用
  */
@@ -148,6 +159,30 @@ interface InferSchemaOptions {
  */
 declare function inferSchema(rawData: any, options?: InferSchemaOptions): InferredSchema;
 
+/**
+ * POST /api/structureData 返回的结构化结果（与 server AIProcessedData 一致）
+ */
+interface StructureDataResult {
+    source: string;
+    category: string;
+    content: string;
+    tags: string[];
+    images?: string[];
+    metadata?: Record<string, unknown>;
+}
+interface FetchStructureDataOptions {
+    systemPrompt?: string;
+    temperature?: number;
+}
+/**
+ * 从 SSE 响应文本中解析最后一条 result 或 error
+ */
+declare function parseSSEResult(sseText: string): StructureDataResult;
+/**
+ * 请求 server 的 POST /api/structureData，传入 schema，返回结构化结果
+ */
+declare function fetchStructureData(serverUrl: string, schema: InferredSchema, options?: FetchStructureDataOptions): Promise<StructureDataResult>;
+
 /**
  * Base64 数据隔离和替换工具
  * 用于在 LLM 处理前替换 base64 图片数据，减少输入大小
@@ -175,4 +210,4 @@ declare function restoreBase64(data: any, replacements: Map<string, string>): an
  */
 declare function extractImages(data: any): string[];
 
-export { AgentLinkClient, type AgentLinkClientOptions, DEFAULT_SERVER_URL, type InferSchemaOptions, type InferredSchema, type SenderInfo, type URLData, type WhitelistInfo, type WhitelistResponse, base64ToUint8Array, compress, decodeDataFromUrl, decompress, encodeDataToUrl, extractAndReplaceBase64, extractImages, fetchWhitelistInfo, inferSchema, restoreBase64, uint8ArrayToBase64, verifyWhitelist };
+export { AgentLinkClient, type AgentLinkClientOptions, type CapabilitiesResponse, DEFAULT_SERVER_URL, type FetchStructureDataOptions, type InferSchemaOptions, type InferredSchema, type SenderInfo, type StructureDataResult, type URLData, type WhitelistInfo, type WhitelistResponse, base64ToUint8Array, compress, decodeDataFromUrl, decompress, encodeDataToUrl, extractAndReplaceBase64, extractImages, fetchCapabilities, fetchStructureData, fetchWhitelistInfo, inferSchema, parseSSEResult, restoreBase64, uint8ArrayToBase64, verifyWhitelist };

package/dist/index.js

@@ -29,8 +29,11 @@ __export(index_exports, {
   encodeDataToUrl: () => encodeDataToUrl,
   extractAndReplaceBase64: () => extractAndReplaceBase64,
   extractImages: () => extractImages,
+  fetchCapabilities: () => fetchCapabilities,
+  fetchStructureData: () => fetchStructureData,
   fetchWhitelistInfo: () => fetchWhitelistInfo,
   inferSchema: () => inferSchema,
+  parseSSEResult: () => parseSSEResult,
   restoreBase64: () => restoreBase64,
   uint8ArrayToBase64: () => uint8ArrayToBase64,
   verifyWhitelist: () => verifyWhitelist
@@ -344,6 +347,68 @@ _AgentLinkClient.whitelistCache = /* @__PURE__ */ new Map();
 _AgentLinkClient.CACHE_TTL = 60 * 60 * 1e3;
 var AgentLinkClient = _AgentLinkClient;
 
+// src/utils/capabilities.ts
+async function fetchCapabilities(serverUrl) {
+  const base = serverUrl.replace(/\/$/, "");
+  const res = await fetch(`${base}/api/capabilities`);
+  if (!res.ok) {
+    throw new Error(`Capabilities request failed: ${res.status} ${res.statusText}`);
+  }
+  const data = await res.json();
+  return {
+    structureData: !!data.structureData
+  };
+}
+
+// src/utils/structureData.ts
+function parseSSEResult(sseText) {
+  const lines = sseText.split("\n").filter((l) => l.startsWith("data: "));
+  for (let i = lines.length - 1; i >= 0; i--) {
+    const data = lines[i].replace(/^data: /, "").trim();
+    try {
+      const json = JSON.parse(data);
+      if (json.result) {
+        const r = json.result;
+        return {
+          source: String(r.source ?? ""),
+          category: String(r.category ?? ""),
+          content: String(r.content ?? ""),
+          tags: Array.isArray(r.tags) ? r.tags.map(String) : [],
+          images: r.images,
+          metadata: r.metadata
+        };
+      }
+      if (json.error) {
+        throw new Error(String(json.error));
+      }
+    } catch (e) {
+      if (e instanceof Error && e.message !== "Unexpected end of JSON input") {
+        throw e;
+      }
+    }
+  }
+  throw new Error("No result in SSE stream");
+}
+async function fetchStructureData(serverUrl, schema, options) {
+  const base = serverUrl.replace(/\/$/, "");
+  const body = { schema };
+  if (options?.systemPrompt != null) body.systemPrompt = options.systemPrompt;
+  if (options?.temperature != null) body.temperature = options.temperature;
+  const res = await fetch(`${base}/api/structureData`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify(body)
+  });
+  if (!res.ok) {
+    const err = await res.json().catch(() => ({}));
+    throw new Error(
+      err.error || `StructureData request failed: ${res.status} ${res.statusText}`
+    );
+  }
+  const text = await res.text();
+  return parseSSEResult(text);
+}
+
 // src/utils/base64.ts
 var DATA_URL_REGEX = /data:image\/[^;]+;base64,[A-Za-z0-9+/=]+/gi;
 function extractAndReplaceBase64(data) {

package/dist/index.mjs

@@ -305,6 +305,68 @@ _AgentLinkClient.whitelistCache = /* @__PURE__ */ new Map();
 _AgentLinkClient.CACHE_TTL = 60 * 60 * 1e3;
 var AgentLinkClient = _AgentLinkClient;
 
+// src/utils/capabilities.ts
+async function fetchCapabilities(serverUrl) {
+  const base = serverUrl.replace(/\/$/, "");
+  const res = await fetch(`${base}/api/capabilities`);
+  if (!res.ok) {
+    throw new Error(`Capabilities request failed: ${res.status} ${res.statusText}`);
+  }
+  const data = await res.json();
+  return {
+    structureData: !!data.structureData
+  };
+}
+
+// src/utils/structureData.ts
+function parseSSEResult(sseText) {
+  const lines = sseText.split("\n").filter((l) => l.startsWith("data: "));
+  for (let i = lines.length - 1; i >= 0; i--) {
+    const data = lines[i].replace(/^data: /, "").trim();
+    try {
+      const json = JSON.parse(data);
+      if (json.result) {
+        const r = json.result;
+        return {
+          source: String(r.source ?? ""),
+          category: String(r.category ?? ""),
+          content: String(r.content ?? ""),
+          tags: Array.isArray(r.tags) ? r.tags.map(String) : [],
+          images: r.images,
+          metadata: r.metadata
+        };
+      }
+      if (json.error) {
+        throw new Error(String(json.error));
+      }
+    } catch (e) {
+      if (e instanceof Error && e.message !== "Unexpected end of JSON input") {
+        throw e;
+      }
+    }
+  }
+  throw new Error("No result in SSE stream");
+}
+async function fetchStructureData(serverUrl, schema, options) {
+  const base = serverUrl.replace(/\/$/, "");
+  const body = { schema };
+  if (options?.systemPrompt != null) body.systemPrompt = options.systemPrompt;
+  if (options?.temperature != null) body.temperature = options.temperature;
+  const res = await fetch(`${base}/api/structureData`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify(body)
+  });
+  if (!res.ok) {
+    const err = await res.json().catch(() => ({}));
+    throw new Error(
+      err.error || `StructureData request failed: ${res.status} ${res.statusText}`
+    );
+  }
+  const text = await res.text();
+  return parseSSEResult(text);
+}
+
 // src/utils/base64.ts
 var DATA_URL_REGEX = /data:image\/[^;]+;base64,[A-Za-z0-9+/=]+/gi;
 function extractAndReplaceBase64(data) {
@@ -479,8 +541,11 @@ export {
   encodeDataToUrl,
   extractAndReplaceBase64,
   extractImages,
+  fetchCapabilities,
+  fetchStructureData,
   fetchWhitelistInfo,
   inferSchema,
+  parseSSEResult,
   restoreBase64,
   uint8ArrayToBase64,
   verifyWhitelist

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "agentlink-sdk",
-    "version": "1.0.8",
+    "version": "1.0.9",
     "description": "AgentLink client SDK for cross-domain data synchronization via URL hash",
     "main": "dist/index.js",
     "module": "dist/index.esm.js",

package/scripts/test-llm-schema.ts

@@ -3,7 +3,7 @@
  * 复用包内 inferSchema、extractImages，仅发送 schema 请求 LLM，再按前端方式回填拼接。
  *
  * LLM 配置（二选一，在脚本内通过环境变量配置）：
- * - 方式 A：AGENTLINK_SERVER_URL  — 请求该地址的 /api/memory/llm/process（需先启动 apps/server）
+ * - 方式 A：AGENTLINK_SERVER_URL  — 请求该地址的 /api/structureData（需先启动 apps/server）
  * - 方式 B：LLM_API_URL + LLM_API_KEY（及可选 LLM_MODEL）— 直接请求 OpenAI 兼容 API
  *
  * 运行：npm run test:llm-schema  或  npx tsx scripts/test-llm-schema.ts
@@ -24,7 +24,7 @@ interface AIProcessedData {
 function getApiUrl(): string {
   const serverUrl = process.env.AGENTLINK_SERVER_URL;
   const llmUrl = process.env.LLM_API_URL;
-  if (serverUrl) return `${serverUrl.replace(/\/$/, '')}/api/memory/llm/process`;
+  if (serverUrl) return `${serverUrl.replace(/\/$/, '')}/api/structureData`;
   if (llmUrl) return ''; // 表示用方式 B，脚本内直接调 LLM
   throw new Error(
     '请配置 LLM：设置 AGENTLINK_SERVER_URL（方式 A）或 LLM_API_URL + LLM_API_KEY（方式 B）'