@acontext/acontext 0.1.13 → 0.1.15

package/README.md

@@ -10,4 +10,4 @@ npm install @acontext/acontext
 
 # 🔍 Document
 
-To understand more about this SDK, please view [our docs](https://docs.acontext.app/) and [api references](https://docs.acontext.app/api-reference/introduction)
+To understand more about this SDK, please view [our docs](https://docs.acontext.io/) and [api references](https://docs.acontext.io/api-reference/introduction)

package/dist/resources/skills.d.ts

@@ -3,7 +3,7 @@
  */
 import { RequesterProtocol } from '../client-types';
 import { FileUpload } from '../uploads';
-import { DownloadSkillToSandboxResp, GetSkillFileResp, ListSkillsOutput, Skill } from '../types';
+import { DownloadSkillResp, DownloadSkillToSandboxResp, GetSkillFileResp, ListSkillsOutput, Skill } from '../types';
 export declare class SkillsAPI {
     private requester;
     constructor(requester: RequesterProtocol);
@@ -54,6 +54,20 @@ export declare class SkillsAPI {
         filePath: string;
         expire?: number | null;
     }): Promise<GetSkillFileResp>;
+    /**
+     * Download all files from a skill to a local directory.
+     *
+     * Recursively downloads every file in the skill's file_index,
+     * preserving the directory structure.
+     *
+     * @param skillId - The UUID of the skill
+     * @param options - Download options
+     * @param options.path - Local directory path to download files into
+     * @returns DownloadSkillResp with skill name, description, resolved dirPath, and list of downloaded file paths
+     */
+    download(skillId: string, options: {
+        path: string;
+    }): Promise<DownloadSkillResp>;
     /**
      * Download all files from a skill to a sandbox environment.
      *

package/dist/resources/skills.js

@@ -2,8 +2,43 @@
 /**
  * Skills endpoints.
  */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SkillsAPI = void 0;
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
 const uploads_1 = require("../uploads");
 const utils_1 = require("../utils");
 const types_1 = require("../types");
@@ -93,6 +128,46 @@ class SkillsAPI {
         });
         return types_1.GetSkillFileRespSchema.parse(data);
     }
+    /**
+     * Download all files from a skill to a local directory.
+     *
+     * Recursively downloads every file in the skill's file_index,
+     * preserving the directory structure.
+     *
+     * @param skillId - The UUID of the skill
+     * @param options - Download options
+     * @param options.path - Local directory path to download files into
+     * @returns DownloadSkillResp with skill name, description, resolved dirPath, and list of downloaded file paths
+     */
+    async download(skillId, options) {
+        const skill = await this.get(skillId);
+        const dest = path.resolve(options.path);
+        await fs.mkdir(dest, { recursive: true });
+        const downloaded = [];
+        for (const fi of skill.file_index) {
+            const resp = await this.getFile({ skillId, filePath: fi.path });
+            const fileDest = path.join(dest, fi.path);
+            await fs.mkdir(path.dirname(fileDest), { recursive: true });
+            if (resp.content) {
+                await fs.writeFile(fileDest, resp.content.raw, 'utf-8');
+            }
+            else if (resp.url) {
+                const r = await fetch(resp.url);
+                if (!r.ok) {
+                    throw new Error(`Failed to download ${fi.path}: ${r.status} ${r.statusText}`);
+                }
+                const buffer = Buffer.from(await r.arrayBuffer());
+                await fs.writeFile(fileDest, buffer);
+            }
+            downloaded.push(fi.path);
+        }
+        return {
+            name: skill.name,
+            description: skill.description,
+            dirPath: dest,
+            files: downloaded,
+        };
+    }
     /**
      * Download all files from a skill to a sandbox environment.
      *

package/dist/types/skill.d.ts

@@ -53,3 +53,10 @@ export declare const DownloadSkillToSandboxRespSchema: z.ZodObject<{
     description: z.ZodString;
 }, z.core.$strip>;
 export type DownloadSkillToSandboxResp = z.infer<typeof DownloadSkillToSandboxRespSchema>;
+export declare const DownloadSkillRespSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    dirPath: z.ZodString;
+    files: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type DownloadSkillResp = z.infer<typeof DownloadSkillRespSchema>;

package/dist/types/skill.js

@@ -3,7 +3,7 @@
  * Type definitions for skill resources.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DownloadSkillToSandboxRespSchema = exports.GetSkillFileRespSchema = exports.ListSkillsOutputSchema = exports.SkillCatalogItemSchema = exports.SkillSchema = exports.FileInfoSchema = void 0;
+exports.DownloadSkillRespSchema = exports.DownloadSkillToSandboxRespSchema = exports.GetSkillFileRespSchema = exports.ListSkillsOutputSchema = exports.SkillCatalogItemSchema = exports.SkillSchema = exports.FileInfoSchema = void 0;
 const zod_1 = require("zod");
 const common_1 = require("./common");
 exports.FileInfoSchema = zod_1.z.object({
@@ -42,3 +42,9 @@ exports.DownloadSkillToSandboxRespSchema = zod_1.z.object({
     name: zod_1.z.string(),
     description: zod_1.z.string(),
 });
+exports.DownloadSkillRespSchema = zod_1.z.object({
+    name: zod_1.z.string(),
+    description: zod_1.z.string(),
+    dirPath: zod_1.z.string(),
+    files: zod_1.z.array(zod_1.z.string()),
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@acontext/acontext",
-  "version": "0.1.13",
+  "version": "0.1.15",
   "description": "TypeScript SDK for the Acontext API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",