@acontext/acontext 0.0.2 → 0.0.3

package/README.md

@@ -37,6 +37,25 @@ await client.sessions.flush(session.id);
 
 See the inline documentation for the full list of helpers covering sessions, spaces, disks, and artifact uploads.
 
+## Health Check
+
+Test connectivity to the Acontext API server:
+
+```typescript
+import { AcontextClient } from '@acontext/acontext';
+
+const client = new AcontextClient({ apiKey: 'sk-ac-your-root-api-bearer-token' });
+
+// Ping the server
+const pong = await client.ping();
+console.log(`Server responded: ${pong}`); // Output: Server responded: pong
+```
+
+This is useful for:
+- Verifying API connectivity before performing operations
+- Health checks in monitoring systems
+- Debugging connection issues
+
 ## Managing disks and artifacts
 
 Artifacts now live under project disks. Create a disk first, then upload files through the disk-scoped helper:
@@ -156,7 +175,7 @@ if (result.final_answer) {
 }
 ```
 
-### 2. Semantic Global (Search page/folder titles)
+### 2. Semantic Glob (Search page/folder titles)
 
 Search for pages and folders by their titles using semantic similarity (like a semantic version of `glob`):
 

package/dist/client.d.ts

@@ -26,6 +26,14 @@ export declare class AcontextClient implements RequesterProtocol {
     tools: ToolsAPI;
     constructor(options?: AcontextClientOptions);
     get baseUrl(): string;
+    /**
+     * Ping the API server to check connectivity.
+     *
+     * @returns Promise resolving to "pong" if the server is reachable and responding.
+     * @throws {APIError} If the server returns an error response.
+     * @throws {TransportError} If there's a network connectivity issue.
+     */
+    ping(): Promise<string>;
     request<T = unknown>(method: string, path: string, options?: {
         params?: Record<string, string | number>;
         jsonData?: unknown;

package/dist/client.js

@@ -81,6 +81,19 @@ class AcontextClient {
     get baseUrl() {
         return this._baseUrl;
     }
+    /**
+     * Ping the API server to check connectivity.
+     *
+     * @returns Promise resolving to "pong" if the server is reachable and responding.
+     * @throws {APIError} If the server returns an error response.
+     * @throws {TransportError} If there's a network connectivity issue.
+     */
+    async ping() {
+        const response = await this.request('GET', '/ping', {
+            unwrap: false,
+        });
+        return response.msg || 'pong';
+    }
     async request(method, path, options) {
         const unwrap = options?.unwrap !== false;
         const url = `${this._baseUrl}${path}`;

package/dist/resources/sessions.js

@@ -124,7 +124,7 @@ class SessionsAPI {
             limit: options?.limit ?? null,
             cursor: options?.cursor ?? null,
             with_asset_public_url: options?.withAssetPublicUrl ?? null,
-            time_desc: options?.timeDesc ?? null,
+            time_desc: options?.timeDesc ?? true, // Default to true
         }));
         const data = await this.requester.request('GET', `/session/${sessionId}/messages`, {
             params: Object.keys(params).length > 0 ? params : undefined,

package/dist/resources/spaces.d.ts

@@ -38,7 +38,7 @@ export declare class SpacesAPI {
         maxIterations?: number | null;
     }): Promise<SpaceSearchResult>;
     /**
-     * Perform semantic global (glob) search for page/folder titles.
+     * Perform semantic glob (glob) search for page/folder titles.
      *
      * Searches specifically for page/folder titles using semantic similarity,
      * similar to a semantic version of the glob command.

package/dist/resources/spaces.js

@@ -67,7 +67,7 @@ class SpacesAPI {
         return types_1.SpaceSearchResultSchema.parse(data);
     }
     /**
-     * Perform semantic global (glob) search for page/folder titles.
+     * Perform semantic glob (glob) search for page/folder titles.
      *
      * Searches specifically for page/folder titles using semantic similarity,
      * similar to a semantic version of the glob command.
@@ -82,7 +82,7 @@ class SpacesAPI {
             limit: options.limit ?? null,
             threshold: options.threshold ?? null,
         });
-        const data = await this.requester.request('GET', `/space/${spaceId}/semantic_global`, { params: Object.keys(params).length > 0 ? params : undefined });
+        const data = await this.requester.request('GET', `/space/${spaceId}/semantic_glob`, { params: Object.keys(params).length > 0 ? params : undefined });
         return data.map((item) => types_1.SearchResultBlockItemSchema.parse(item));
     }
     /**

package/package.json

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