Add Agent constructor class and fix API response handling

- Create Agent class with constructor-based API for consistency
- Update README and examples to use new Agent() constructor
- Fix RemoteState.getConversationInfo() to handle full_state wrapper
- Export Agent class and AgentOptions type from main index
- Update React example to use new Agent constructor pattern

Co-authored-by: openhands <openhands@all-hands.dev>

Author: openhands-agent

README.md

@@ -23,13 +23,13 @@ npm install @openhands/agent-server-typescript-client
 ```typescript
 import { Conversation, Agent, Workspace } from '@openhands/agent-server-typescript-client';
 
-const agent: Agent = {
+const agent = new Agent({
   kind: 'CodeActAgent',
   llm: {
     model: 'gpt-4',
     api_key: 'your-openai-api-key'
   }
-};
+});
 
 // Create a remote workspace
 const workspace = new Workspace({

example/src/components/ConversationManager.tsx

@@ -192,13 +192,13 @@ export const ConversationManager: React.FC = () => {
     setError(null);
     try {
       // Create a simple agent configuration
-      const agent: Agent = {
+      const agent = new Agent({
         kind: 'Agent',
         llm: {
           model: settings.modelName,
           api_key: settings.apiKey || ''
         }
-      };
+      });
 
       // Create a remote workspace
       const workspace = new Workspace({

src/agent/agent.ts

@@ -0,0 +1,45 @@
+/**
+ * Agent class that provides a constructor-based API for creating agents.
+ * Provides a cleaner API that matches the Python SDK naming.
+ */
+
+import { AgentBase, LLM } from '../types/base';
+
+export interface AgentOptions {
+  llm: LLM;
+  kind?: string;
+  name?: string;
+  [key: string]: any;
+}
+
+/**
+ * Agent class that implements AgentBase interface.
+ * Provides a constructor-based API for creating agents.
+ * 
+ * Usage:
+ *   const agent = new Agent({
+ *     llm: {
+ *       model: 'gpt-4',
+ *       api_key: 'your-key'
+ *     }
+ *   });
+ */
+export class Agent implements AgentBase {
+  kind: string;
+  llm: LLM;
+  name?: string;
+  [key: string]: any;
+
+  constructor(options: AgentOptions) {
+    this.kind = options.kind || 'Agent';
+    this.llm = options.llm;
+    this.name = options.name;
+    
+    // Copy any additional properties
+    Object.keys(options).forEach(key => {
+      if (key !== 'kind' && key !== 'llm' && key !== 'name') {
+        this[key] = options[key];
+      }
+    });
+  }
+}

src/agent/index.ts

@@ -0,0 +1 @@
+export { Agent, AgentOptions } from './agent';

src/conversation/remote-state.ts

@@ -44,12 +44,20 @@ export class RemoteState {
       }
 
       // Fallback to REST API if no cached state
-      const response = await this.client.get<ConversationInfo>(
+      const response = await this.client.get<any>(
         `/api/conversations/${this.conversationId}`
       );
-      const state = response.data;
-      this.cachedState = state;
-      return state;
+      
+      // Handle the case where the API returns a full_state wrapper
+      let conversationInfo: ConversationInfo;
+      if (response.data.full_state) {
+        conversationInfo = response.data.full_state as ConversationInfo;
+      } else {
+        conversationInfo = response.data as ConversationInfo;
+      }
+      
+      this.cachedState = conversationInfo;
+      return conversationInfo;
     });
   }
 

src/index.ts

@@ -14,6 +14,9 @@ export { Workspace } from './workspace/workspace';
 export { RemoteState } from './conversation/remote-state';
 export { RemoteEventsList } from './events/remote-events-list';
 
+// Agent classes
+export { Agent } from './agent/agent';
+
 // WebSocket client for real-time events
 export { WebSocketCallbackClient } from './events/websocket-client';
 
@@ -35,7 +38,6 @@ export type {
   TextContent,
   ImageContent,
   AgentBase,
-  Agent,
   LLM,
   ServerInfo,
   Success,
@@ -48,6 +50,8 @@ export type {
   AlwaysConfirm,
 } from './types/base';
 
+export type { AgentOptions } from './agent/agent';
+
 export { EventSortOrder, AgentExecutionStatus } from './types/base';
 
 // Workspace models
@@ -88,6 +92,7 @@ import { RemoteEventsList } from './events/remote-events-list';
 import { WebSocketCallbackClient } from './events/websocket-client';
 import { HttpClient, HttpError } from './client/http-client';
 import { EventSortOrder, AgentExecutionStatus } from './types/base';
+import { Agent } from './agent/agent';
 
 // Default export for convenience
 export default {
@@ -103,4 +108,5 @@ export default {
   HttpError,
   EventSortOrder,
   AgentExecutionStatus,
+  Agent,
 };