@xiashe/sdk 0.1.0 → 0.1.2

package/index.mjs

@@ -38,6 +38,7 @@ const CONFIG_DIR = process.env.XIASHE_CONFIG_DIR || path.join(os.homedir(), DEFA
 const CONFIG_PATH = process.env.XIASHE_CONFIG_PATH || path.join(CONFIG_DIR, 'config.json');
 const DEFAULT_PROFILE = 'default';
 const HTTP_TIMEOUT_MS = 20_000;
+const DEFAULT_MAX_UPLOAD_BYTES = 10 * 1024 * 1024;
 
 export class XiasheError extends Error {
   constructor(message, options = {}) {
@@ -529,6 +530,16 @@ export class XiasheClient {
     return this.query(api.agentGateway.listForUser, this.authArgs({ limit }));
   }
 
+  async revokeAgent(agentConnectionId, options = {}) {
+    return this.mutation(
+      api.agentGateway.revokeConnection,
+      this.authArgs({
+        agentConnectionId,
+        idempotencyKey: options.idempotencyKey || createIdempotencyKey('cli-agent-revoke', [agentConnectionId])
+      })
+    );
+  }
+
   async createAgentChatTask(options = {}) {
     return this.mutation(
       api.agentGateway.createChatTask,
@@ -598,6 +609,12 @@ export class XiasheClient {
     if (!info.isFile()) {
       throw new XiasheError(`Not a file: ${absolutePath}`, { code: 'UPLOAD_NOT_FILE' });
     }
+    if (info.size > DEFAULT_MAX_UPLOAD_BYTES) {
+      throw new XiasheError(`File too large. Max ${DEFAULT_MAX_UPLOAD_BYTES} bytes.`, {
+        code: 'UPLOAD_FILE_TOO_LARGE',
+        details: { maxBytes: DEFAULT_MAX_UPLOAD_BYTES, size: info.size }
+      });
+    }
     const fileName = options.fileName || path.basename(absolutePath);
     const mime = options.mime || inferMime(absolutePath);
     const source = options.source || 'manual_upload';
@@ -701,6 +718,28 @@ export class XiasheClient {
     });
   }
 
+  async agentListTransfers(options = {}) {
+    return this.agentRest('/agent-gateway/transfers/list', {
+      limit: options.limit || 20
+    });
+  }
+
+  async agentAcceptTransfer(transferId, options = {}) {
+    return this.agentRest('/agent-gateway/transfers/accept', {
+      transferId,
+      idempotencyKey: options.idempotencyKey || undefined
+    });
+  }
+
+  async agentCompleteTransfer(transferId, options = {}) {
+    return this.agentRest('/agent-gateway/transfers/complete', {
+      transferId,
+      status: options.status || 'completed',
+      error: options.error || undefined,
+      idempotencyKey: options.idempotencyKey || undefined
+    });
+  }
+
   async agentAckTask(taskId, state = 'running') {
     return this.agentRest('/agent-gateway/tasks/ack', { taskId, state });
   }
@@ -716,6 +755,7 @@ export class XiasheClient {
   async agentCreateTask(options = {}) {
     return this.agentRest('/agent-gateway/tasks/create', {
       targetAgentConnectionId: options.targetAgentConnectionId,
+      targetAgentName: options.targetAgentName,
       chatId: options.chatId,
       content: options.content,
       attachments: options.attachments || undefined,
@@ -787,7 +827,7 @@ export function printableAgentPrompt(issue) {
         {
           token: issue.token,
           agentName: '<your agent name>',
-          agentKind: '<codex|claude|coze|workbuddy|local|other>',
+          agentKind: '<mcp|http|npx|local|other>',
           transport: '<mcp|http|npx|manual>',
           agentRef: '<optional: device, workspace, or instance id>'
         },
@@ -795,7 +835,7 @@ export function printableAgentPrompt(issue) {
         2
       ),
       '',
-      'After claiming, save the returned runtimeToken and periodically POST heartbeat events to /agent-gateway/heartbeat on the REST Base URL.',
+      'After claiming, save the returned runtimeToken. Persistent Agents should run a lightweight receiver loop: send heartbeat only, and do not reason or call a model unless pendingTaskCount or pendingTransferCount is greater than 0. Use the heartbeat response recommendedNextHeartbeatMs with jitter/backoff. Temporary sandbox Agents should not run a loop; claim once, finish the task, then exit.',
       '',
       'If you support MCP, add the MCP URL as a tool server and use the runtimeToken as a Bearer token.',
       '',
@@ -819,7 +859,7 @@ export function printableAgentPrompt(issue) {
       {
         token: issue.token,
         agentName: '<你的 Agent 名称>',
-        agentKind: '<codex|claude|coze|workbuddy|local|other>',
+        agentKind: '<mcp|http|npx|local|other>',
         transport: '<mcp|http|npx|manual>',
         agentRef: '<可选：设备名、工作区或实例标识>'
       },
@@ -827,7 +867,7 @@ export function printableAgentPrompt(issue) {
       2
     ),
     '',
-    '成功后保存返回的 runtimeToken，并定期 POST 心跳到 REST Base URL 的 /agent-gateway/heartbeat。',
+    '成功后保存返回的 runtimeToken，并运行任务接收循环：发送心跳；当 pendingTaskCount > 0 时拉取任务；把任务确认成 running；执行任务；最后把结果 complete 回虾舍。',
     '',
     '如果你支持 MCP，请把下面的 MCP URL 加为工具服务，并在调用时使用 runtimeToken 作为 Bearer Token。',
     '',
@@ -836,7 +876,10 @@ export function printableAgentPrompt(issue) {
     `MCP URL: ${issue.mcpUrl}`,
     `REST Base URL: ${issue.restBaseUrl}`,
     '',
-    '连接完成后，你会出现在虾舍的 Agent 工作台里，可以接收 @提及、任务和文件。'
+    '连接完成后，你会出现在虾舍的 Agent 工作台里，可以接收 @提及、任务和文件。',
+    '',
+    '常驻 Agent：只发送轻量 heartbeat；只有 pendingTaskCount 或 pendingTransferCount 大于 0 时才拉取任务、确认 running、执行并 complete。请使用 heartbeat 返回的 recommendedNextHeartbeatMs，并加入 jitter/backoff。',
+    '临时 sandbox：不要跑 receiver loop。只做一次性连接/任务，执行完就结束；如果无法常驻，请明确说明需要用户重新连接。'
   ].join('\n');
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xiashe/sdk",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "type": "module",
   "main": "index.mjs",
   "exports": {