@acontext/acontext 0.1.12 → 0.1.14

package/dist/errors.d.ts

@@ -30,3 +30,9 @@ export declare class APIError extends AcontextError {
 export declare class TransportError extends AcontextError {
     constructor(message: string);
 }
+/**
+ * Raised when a polling operation exceeds the configured timeout.
+ */
+export declare class TimeoutError extends AcontextError {
+    constructor(message?: string);
+}

package/dist/errors.js

@@ -3,7 +3,7 @@
  * Custom exceptions raised by the acontext TypeScript client.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TransportError = exports.APIError = exports.AcontextError = void 0;
+exports.TimeoutError = exports.TransportError = exports.APIError = exports.AcontextError = void 0;
 /**
  * Base exception for all errors raised by `acontext`.
  */
@@ -43,3 +43,14 @@ class TransportError extends AcontextError {
     }
 }
 exports.TransportError = TransportError;
+/**
+ * Raised when a polling operation exceeds the configured timeout.
+ */
+class TimeoutError extends AcontextError {
+    constructor(message = 'operation timed out') {
+        super(message);
+        this.name = 'TimeoutError';
+        Object.setPrototypeOf(this, TimeoutError.prototype);
+    }
+}
+exports.TimeoutError = TimeoutError;

package/dist/index.d.ts

@@ -5,7 +5,7 @@ export { AcontextClient } from './client';
 export type { AcontextClientOptions } from './client';
 export { FileUpload } from './uploads';
 export { MessagePart, AcontextMessage, buildAcontextMessage } from './messages';
-export { APIError, TransportError, AcontextError } from './errors';
+export { APIError, TransportError, AcontextError, TimeoutError } from './errors';
 export * from './types';
 export * from './resources';
 export * from './agent';

package/dist/index.js

@@ -17,7 +17,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AcontextError = exports.TransportError = exports.APIError = exports.buildAcontextMessage = exports.AcontextMessage = exports.MessagePart = exports.FileUpload = exports.AcontextClient = void 0;
+exports.TimeoutError = exports.AcontextError = exports.TransportError = exports.APIError = exports.buildAcontextMessage = exports.AcontextMessage = exports.MessagePart = exports.FileUpload = exports.AcontextClient = void 0;
 var client_1 = require("./client");
 Object.defineProperty(exports, "AcontextClient", { enumerable: true, get: function () { return client_1.AcontextClient; } });
 var uploads_1 = require("./uploads");
@@ -30,6 +30,7 @@ var errors_1 = require("./errors");
 Object.defineProperty(exports, "APIError", { enumerable: true, get: function () { return errors_1.APIError; } });
 Object.defineProperty(exports, "TransportError", { enumerable: true, get: function () { return errors_1.TransportError; } });
 Object.defineProperty(exports, "AcontextError", { enumerable: true, get: function () { return errors_1.AcontextError; } });
+Object.defineProperty(exports, "TimeoutError", { enumerable: true, get: function () { return errors_1.TimeoutError; } });
 __exportStar(require("./types"), exports);
 __exportStar(require("./resources"), exports);
 __exportStar(require("./agent"), exports);

package/dist/resources/learning-spaces.d.ts

@@ -44,6 +44,22 @@ export declare class LearningSpacesAPI {
         spaceId: string;
         sessionId: string;
     }): Promise<LearningSpaceSession>;
+    /**
+     * Get a single learning session record by session ID.
+     */
+    getSession(options: {
+        spaceId: string;
+        sessionId: string;
+    }): Promise<LearningSpaceSession>;
+    /**
+     * Poll until a learning session reaches a terminal status.
+     */
+    waitForLearning(options: {
+        spaceId: string;
+        sessionId: string;
+        timeout?: number;
+        pollInterval?: number;
+    }): Promise<LearningSpaceSession>;
     /**
      * List all learning session records for a space.
      */

package/dist/resources/learning-spaces.js

@@ -4,6 +4,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.LearningSpacesAPI = void 0;
+const errors_1 = require("../errors");
 const utils_1 = require("../utils");
 const types_1 = require("../types");
 class LearningSpacesAPI {
@@ -74,6 +75,36 @@ class LearningSpacesAPI {
         const data = await this.requester.request('POST', `/learning_spaces/${options.spaceId}/learn`, { jsonData: { session_id: options.sessionId } });
         return types_1.LearningSpaceSessionSchema.parse(data);
     }
+    /**
+     * Get a single learning session record by session ID.
+     */
+    async getSession(options) {
+        const data = await this.requester.request('GET', `/learning_spaces/${options.spaceId}/sessions/${options.sessionId}`);
+        return types_1.LearningSpaceSessionSchema.parse(data);
+    }
+    /**
+     * Poll until a learning session reaches a terminal status.
+     */
+    async waitForLearning(options) {
+        const timeout = options.timeout ?? 120;
+        const pollInterval = options.pollInterval ?? 1;
+        const terminal = new Set(['completed', 'failed']);
+        const deadline = Date.now() + timeout * 1000;
+        while (true) {
+            const session = await this.getSession({
+                spaceId: options.spaceId,
+                sessionId: options.sessionId,
+            });
+            if (terminal.has(session.status)) {
+                return session;
+            }
+            if (Date.now() >= deadline) {
+                throw new errors_1.TimeoutError(`learning session ${options.sessionId} did not complete within ${timeout}s ` +
+                    `(last status: ${session.status})`);
+            }
+            await new Promise((resolve) => setTimeout(resolve, pollInterval * 1000));
+        }
+    }
     /**
      * List all learning session records for a space.
      */

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.12",
+  "version": "0.1.14",
   "description": "TypeScript SDK for the Acontext API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",