@agentuity/server 0.0.60 → 0.0.62

package/src/api/project/deployment.ts

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import { type APIClient, APIResponseSchema, APIResponseSchemaOptionalData } from '../api';
+import { ProjectResponseError } from './util';
 
 // Simplified metadata schema for the client
 const DeploymentMetadataSchema = z.object({
@@ -69,7 +70,7 @@ export async function projectDeploymentList(
 	if (resp.success) {
 		return resp.data;
 	}
-	throw new Error(resp.message);
+	throw new ProjectResponseError({ message: resp.message });
 }
 
 export async function projectDeploymentGet(
@@ -85,7 +86,7 @@ export async function projectDeploymentGet(
 	if (resp.success) {
 		return resp.data;
 	}
-	throw new Error(resp.message);
+	throw new ProjectResponseError({ message: resp.message });
 }
 
 export async function projectDeploymentDelete(
@@ -99,7 +100,7 @@ export async function projectDeploymentDelete(
 		DeploymentActionResponseSchema
 	);
 	if (!resp.success) {
-		throw new Error(resp.message);
+		throw new ProjectResponseError({ message: resp.message });
 	}
 }
 
@@ -114,7 +115,7 @@ export async function projectDeploymentRollback(
 		DeploymentActionResponseSchema
 	);
 	if (!resp.success) {
-		throw new Error(resp.message);
+		throw new ProjectResponseError({ message: resp.message });
 	}
 }
 
@@ -128,7 +129,7 @@ export async function projectDeploymentUndeploy(
 		DeploymentActionResponseSchema
 	);
 	if (!resp.success) {
-		throw new Error(resp.message);
+		throw new ProjectResponseError({ message: resp.message });
 	}
 }
 
@@ -159,5 +160,5 @@ export async function projectDeploymentLogs(
 	if (resp.success) {
 		return resp.data;
 	}
-	throw new Error(resp.message);
+	throw new ProjectResponseError({ message: resp.message });
 }

package/src/api/project/env-delete.ts

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import { APIClient, APIResponseSchemaNoData } from '../api';
+import { ProjectResponseError } from './util';
 
 const _ProjectEnvDeleteRequestSchema = z.object({
 	id: z.string().describe('the project id'),
@@ -33,7 +34,7 @@ export async function projectEnvDelete(
 	);
 
 	if (!resp.success) {
-		throw new Error(resp.message ?? 'failed to delete project env');
+		throw new ProjectResponseError({ message: resp.message ?? 'failed to delete project env' });
 	}
 
 	// Delete operations don't return data, success is sufficient

package/src/api/project/env-update.ts

@@ -2,6 +2,7 @@ import { z } from 'zod';
 import { APIClient, APIResponseSchema } from '../api';
 import type { Project } from './get';
 import { projectGet } from './get';
+import { ProjectResponseError } from './util';
 
 const _ProjectEnvUpdateRequestSchema = z.object({
 	id: z.string().describe('the project id'),
@@ -46,7 +47,7 @@ export async function projectEnvUpdate(
 	);
 
 	if (!resp.success) {
-		throw new Error(resp.message ?? 'failed to update project env');
+		throw new ProjectResponseError({ message: resp.message ?? 'failed to update project env' });
 	}
 
 	if (resp.data) {

package/src/api/project/exists.ts

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import { APIClient, APIResponseSchema, APIError } from '../api';
+import { ProjectResponseError } from './util';
 
 const _ProjectExistsRequestSchema = z.object({
 	name: z.string().max(255).min(1).describe('the name of the new project'),
@@ -42,16 +43,16 @@ export async function projectExists(
 		return false;
 	} catch (ex) {
 		const _ex = ex as Error;
-		if (_ex.name === 'APIError') {
-			const apiError = _ex as APIError;
-			switch (apiError.status) {
+		if (_ex instanceof APIError) {
+			switch (_ex.status) {
 				case 409:
 					return true;
 				case 422:
 					return false;
 				default:
+					break;
 			}
 		}
-		throw ex;
+		throw new ProjectResponseError({ cause: ex });
 	}
 }

package/src/api/project/get.ts

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import { APIClient, APIResponseSchema } from '../api';
+import { ProjectResponseError } from './util';
 
 const _ProjectGetRequestSchema = z.object({
 	id: z.string().describe('the project id'),
@@ -32,5 +33,5 @@ export async function projectGet(client: APIClient, request: ProjectGetRequest):
 		return resp.data;
 	}
 
-	throw new Error(resp.message);
+	throw new ProjectResponseError({ message: resp.message });
 }

package/src/api/project/list.ts

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import { APIClient, APIResponseSchema } from '../api';
+import { ProjectResponseError } from './util';
 
 const ProjectListResponse = z.array(
 	z.object({
@@ -38,5 +39,5 @@ export async function projectList(
 		return resp.data;
 	}
 
-	throw new Error(resp.message);
+	throw new ProjectResponseError({ message: resp.message });
 }

package/src/api/project/util.ts

@@ -0,0 +1,5 @@
+import { StructuredError } from '@agentuity/core';
+
+export const ProjectResponseError = StructuredError('ProjectResponseError');
+export const ProjectNotFoundError = StructuredError('ProjectNotFoundError')<{ id: string }>();
+export const AgentNotFoundError = StructuredError('AgentNotFoundError')<{ id: string }>();

package/src/api/region/create.ts

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import { APIResponseSchema, APIClient } from '../api';
+import { RegionResponseError } from './util';
 
 const ResourceSpec = z.object({
 	type: z.enum(['db', 's3']).describe('the resource type'),
@@ -51,5 +52,7 @@ export async function createResources(
 	if (resp.success) {
 		return resp.data.created;
 	}
-	throw new Error('message' in resp ? resp.message : 'Failed to create resources');
+	throw new RegionResponseError({
+		message: resp.message,
+	});
 }

package/src/api/region/delete.ts

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import { APIResponseSchema, APIClient } from '../api';
+import { RegionResponseError } from './util';
 
 const DeleteResourceSpec = z.object({
 	type: z.enum(['db', 's3']).describe('the resource type'),
@@ -45,5 +46,5 @@ export async function deleteResources(
 	if (resp.success) {
 		return resp.data.deleted;
 	}
-	throw new Error('message' in resp ? resp.message : 'Failed to delete resources');
+	throw new RegionResponseError({ message: resp.message });
 }

package/src/api/region/list.ts

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import { APIResponseSchema, APIClient } from '../api';
+import { RegionResponseError } from './util';
 
 const ListRegionsResponse = z.array(
 	z.object({
@@ -27,5 +28,5 @@ export async function listRegions(client: APIClient): Promise<RegionList> {
 	if (resp.success) {
 		return resp.data;
 	}
-	throw new Error(resp.message);
+	throw new RegionResponseError({ message: resp.message });
 }

package/src/api/region/resources.ts

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import { APIResponseSchema, APIClient } from '../api';
+import { RegionResponseError } from './util';
 
 const ResourceListResponse = z.object({
 	s3: z.array(
@@ -47,5 +48,5 @@ export async function listResources(
 	if (resp.success) {
 		return resp.data;
 	}
-	throw new Error(resp.message);
+	throw new RegionResponseError({ message: resp.message });
 }

package/src/api/region/util.ts

@@ -0,0 +1,3 @@
+import { StructuredError } from '@agentuity/core';
+
+export const RegionResponseError = StructuredError('RegionResponseError');

package/src/api/session/get.ts

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 import { APIClient, APIResponseSchema } from '../api';
 import { SessionSchema } from './list';
+import { SessionResponseError } from './util';
 
 const _SessionGetRequestSchema = z.object({
 	id: z.string().describe('the session id'),
@@ -22,6 +23,7 @@ export interface SpanNode {
 	operation: string;
 	attributes: Record<string, unknown>;
 	children?: SpanNode[];
+	error?: string;
 }
 
 const SpanNodeSchema: z.ZodType<SpanNode> = z.lazy(() =>
@@ -31,6 +33,7 @@ const SpanNodeSchema: z.ZodType<SpanNode> = z.lazy(() =>
 		operation: z.string().describe('operation name'),
 		attributes: z.record(z.string(), z.unknown()).describe('span attributes'),
 		children: z.array(SpanNodeSchema).optional().describe('child spans'),
+		error: z.string().optional().describe('error message'),
 	})
 );
 
@@ -99,5 +102,5 @@ export async function sessionGet(
 		};
 	}
 
-	throw new Error(resp.message);
+	throw new SessionResponseError({ message: resp.message });
 }

package/src/api/session/list.ts

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import { APIClient, APIResponseSchema } from '../api';
+import { SessionResponseError } from './util';
 
 const SessionSchema = z.object({
 	id: z.string().describe('the session id'),
@@ -32,6 +33,7 @@ const SessionSchema = z.object({
 	route_id: z.string().describe('the route id'),
 	thread_id: z.string().describe('the thread id'),
 	timeline: z.unknown().nullable().optional().describe('the session timeline tree'),
+	user_data: z.string().nullable().optional().describe('the user data as JSON'),
 });
 
 export { SessionSchema };
@@ -104,5 +106,5 @@ export async function sessionList(
 		return resp.data;
 	}
 
-	throw new Error(resp.message);
+	throw new SessionResponseError({ message: resp.message });
 }

package/src/api/session/logs.ts

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import { APIClient, APIResponseSchema } from '../api';
+import { SessionResponseError } from './util';
 
 const _SessionLogsRequestSchema = z.object({
 	id: z.string().describe('the session id'),
@@ -42,5 +43,5 @@ export async function sessionLogs(
 		return resp.data;
 	}
 
-	throw new Error(resp.message);
+	throw new SessionResponseError({ message: resp.message });
 }

package/src/api/session/util.ts

@@ -0,0 +1,3 @@
+import { StructuredError } from '@agentuity/core';
+
+export const SessionResponseError = StructuredError('SessionResponseError');

package/src/api/thread/delete.ts

@@ -0,0 +1,31 @@
+import { z } from 'zod';
+import { APIClient, APIResponseSchemaNoData } from '../api';
+import { ThreadResponseError } from './util';
+
+const _ThreadDeleteRequestSchema = z.object({
+	id: z.string().describe('the thread id'),
+});
+
+const ThreadDeleteResponseSchema = APIResponseSchemaNoData();
+
+type ThreadDeleteRequest = z.infer<typeof _ThreadDeleteRequestSchema>;
+type ThreadDeleteResponse = z.infer<typeof ThreadDeleteResponseSchema>;
+
+/**
+ * Delete a thread by id
+ *
+ * @param client
+ * @param request
+ * @returns
+ */
+export async function threadDelete(client: APIClient, request: ThreadDeleteRequest): Promise<void> {
+	const resp = await client.request<ThreadDeleteResponse>(
+		'DELETE',
+		`/thread/2025-03-17/${request.id}`,
+		ThreadDeleteResponseSchema
+	);
+
+	if (!resp.success) {
+		throw new ThreadResponseError({ message: resp.message });
+	}
+}

package/src/api/thread/get.ts

@@ -0,0 +1,36 @@
+import { z } from 'zod';
+import { APIClient, APIResponseSchema } from '../api';
+import { ThreadSchema } from './list';
+import { ThreadResponseError } from './util';
+
+const _ThreadGetRequestSchema = z.object({
+	id: z.string().describe('the thread id'),
+});
+
+const ThreadGetResponseSchema = APIResponseSchema(ThreadSchema);
+
+type ThreadGetRequest = z.infer<typeof _ThreadGetRequestSchema>;
+type ThreadGetResponse = z.infer<typeof ThreadGetResponseSchema>;
+
+export type Thread = z.infer<typeof ThreadSchema>;
+
+/**
+ * Get a single thread by id
+ *
+ * @param client
+ * @param request
+ * @returns
+ */
+export async function threadGet(client: APIClient, request: ThreadGetRequest): Promise<Thread> {
+	const resp = await client.request<ThreadGetResponse>(
+		'GET',
+		`/thread/2025-03-17/${request.id}`,
+		ThreadGetResponseSchema
+	);
+
+	if (resp.success) {
+		return resp.data;
+	}
+
+	throw new ThreadResponseError({ message: resp.message });
+}

package/src/api/thread/index.ts

@@ -0,0 +1,4 @@
+export { threadGet, type Thread } from './get';
+export { threadList, type ThreadList, type ThreadListOptions, ThreadSchema } from './list';
+export { threadDelete } from './delete';
+export { ThreadResponseError } from './util';

package/src/api/thread/list.ts

@@ -0,0 +1,60 @@
+import { z } from 'zod';
+import { APIClient, APIResponseSchema } from '../api';
+import { ThreadResponseError } from './util';
+
+const ThreadSchema = z.object({
+	id: z.string().describe('the thread id'),
+	created_at: z.string().describe('the creation timestamp'),
+	updated_at: z.string().describe('the last update timestamp'),
+	deleted: z.boolean().describe('whether the thread is deleted'),
+	deleted_at: z.string().nullable().describe('the deletion timestamp'),
+	deleted_by: z.string().nullable().describe('who deleted the thread'),
+	org_id: z.string().describe('the organization id'),
+	project_id: z.string().describe('the project id'),
+	user_data: z.string().nullable().optional().describe('the user data as JSON'),
+});
+
+export { ThreadSchema };
+
+const ThreadListResponse = z.array(ThreadSchema);
+
+const ThreadListResponseSchema = APIResponseSchema(ThreadListResponse);
+
+export type ThreadListResponse = z.infer<typeof ThreadListResponseSchema>;
+export type ThreadList = z.infer<typeof ThreadListResponse>;
+export type Thread = z.infer<typeof ThreadSchema>;
+
+export interface ThreadListOptions {
+	count?: number;
+	orgId?: string;
+	projectId?: string;
+}
+
+/**
+ * List threads
+ *
+ * @param client
+ * @param options filtering and pagination options
+ * @returns
+ */
+export async function threadList(
+	client: APIClient,
+	options: ThreadListOptions = {}
+): Promise<ThreadList> {
+	const { count = 10, orgId, projectId } = options;
+	const params = new URLSearchParams({ count: count.toString() });
+	if (orgId) params.set('orgId', orgId);
+	if (projectId) params.set('projectId', projectId);
+
+	const resp = await client.request<ThreadListResponse>(
+		'GET',
+		`/thread/2025-03-17?${params.toString()}`,
+		ThreadListResponseSchema
+	);
+
+	if (resp.success) {
+		return resp.data;
+	}
+
+	throw new ThreadResponseError({ message: resp.message });
+}

package/src/api/thread/util.ts

@@ -0,0 +1,3 @@
+import { StructuredError } from '@agentuity/core';
+
+export const ThreadResponseError = StructuredError('ThreadResponseError');

package/src/api/user/util.ts

@@ -0,0 +1,3 @@
+import { StructuredError } from '@agentuity/core';
+
+export const UserResponseError = StructuredError('UserResponseError');

package/src/api/user/whoami.ts

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import { APIResponseSchema, APIClient } from '../api';
+import { UserResponseError } from './util';
 
 const OrganizationSchema = z.object({
 	id: z.string().describe('the unique id for the organization'),
@@ -27,5 +28,5 @@ export async function whoami(client: APIClient): Promise<User> {
 	if (resp.success) {
 		return resp.data;
 	}
-	throw new Error(resp.message);
+	throw new UserResponseError({ message: resp.message });
 }

package/src/server.ts

@@ -15,7 +15,7 @@ interface ServiceAdapterConfig {
 		url: string,
 		options: FetchRequest,
 		response: FetchResponse<T>,
-		err?: ServiceException
+		err?: InstanceType<typeof ServiceException>
 	) => Promise<void>;
 }
 
@@ -148,17 +148,17 @@ class ServerFetchAdapter implements FetchAdapter {
 					}
 				} catch (ex) {
 					err = ex as Error;
-					if (this.#config.onAfter) {
+					if (this.#config.onAfter && err instanceof ServiceException) {
 						await this.#config.onAfter(
 							url,
 							options,
 							{
 								ok: false,
-								response: new Response((err as ServiceException).message ?? String(err), {
-									status: (err as ServiceException).statusCode ?? 500,
+								response: new Response(err.message, {
+									status: err.statusCode,
 								}),
 							} as FetchErrorResponse,
-							err as ServiceException
+							err
 						);
 					}
 				}