@agentuity/core 1.0.32 → 1.0.34

package/src/services/env.ts

@@ -0,0 +1,9 @@
+/**
+ * Safe environment variable accessor that works in both browser and server environments.
+ */
+export function getEnv(key: string): string | undefined {
+	if (typeof process !== 'undefined' && process.env) {
+		return process.env[key];
+	}
+	return undefined;
+}

package/src/services/eval/get.ts

@@ -0,0 +1,33 @@
+import { z } from 'zod';
+import { type APIClient, APIResponseSchema } from '../api.ts';
+
+export const EvaluationDetailSchema = z.object({
+	id: z.string().describe('Evaluation ID'),
+	name: z.string().describe('Evaluation name'),
+	description: z.string().nullable().describe('Evaluation description'),
+	identifier: z.string().nullable().describe('Stable evaluation identifier'),
+	agentIdentifier: z.string().describe('Agent identifier'),
+	projectId: z.string().describe('Project ID'),
+	orgId: z.string().describe('Organization ID'),
+	devmode: z.boolean().describe('Whether this is a devmode evaluation'),
+	createdAt: z.string().describe('Creation timestamp'),
+	updatedAt: z.string().describe('Last updated timestamp'),
+});
+
+export const EvalGetResponseSchema = APIResponseSchema(EvaluationDetailSchema);
+
+export type EvaluationDetail = z.infer<typeof EvaluationDetailSchema>;
+
+export async function evalGet(client: APIClient, id: string): Promise<EvaluationDetail> {
+	const resp = await client.request<z.infer<typeof EvalGetResponseSchema>>(
+		'GET',
+		`/cli/eval/${encodeURIComponent(id)}`,
+		EvalGetResponseSchema
+	);
+
+	if (resp.success) {
+		return resp.data;
+	}
+
+	throw new Error(resp.message || 'Failed to get evaluation');
+}

package/src/services/eval/index.ts

@@ -0,0 +1,29 @@
+export * from './events.ts';
+export {
+	EvalGetResponseSchema,
+	type EvaluationDetail,
+	EvaluationDetailSchema,
+	evalGet,
+} from './get.ts';
+export {
+	EvalListResponseData,
+	EvalListResponseSchema,
+	type Evaluation,
+	type EvaluationListRequest,
+	EvaluationSchema,
+	evalList,
+} from './list.ts';
+export {
+	type EvalRunDetail,
+	EvalRunDetailSchema,
+	EvalRunGetResponseSchema,
+	evalRunGet,
+} from './run-get.ts';
+export {
+	type EvalRunListItem,
+	type EvalRunListRequest,
+	EvalRunListResponseData,
+	EvalRunListResponseSchema,
+	EvalRunSchema,
+	evalRunList,
+} from './run-list.ts';

package/src/services/eval/list.ts

@@ -0,0 +1,49 @@
+import { z } from 'zod';
+import { type APIClient, APIResponseSchema } from '../api.ts';
+
+export const EvaluationSchema = z.object({
+	id: z.string().describe('Evaluation ID'),
+	name: z.string().describe('Evaluation name'),
+	description: z.string().nullable().describe('Evaluation description'),
+	identifier: z.string().nullable().describe('Stable evaluation identifier'),
+	agentIdentifier: z.string().describe('Agent identifier'),
+	projectId: z.string().describe('Project ID'),
+	devmode: z.boolean().describe('Whether this is a devmode evaluation'),
+	createdAt: z.string().describe('Creation timestamp'),
+	updatedAt: z.string().describe('Last updated timestamp'),
+});
+
+export const EvalListResponseData = z.array(EvaluationSchema);
+export const EvalListResponseSchema = APIResponseSchema(EvalListResponseData);
+
+export type Evaluation = z.infer<typeof EvaluationSchema>;
+export type EvaluationListRequest = {
+	projectId?: string;
+	agentId?: string;
+	orgId?: string;
+};
+
+export async function evalList(
+	client: APIClient,
+	request: EvaluationListRequest = {}
+): Promise<Evaluation[]> {
+	const params = new URLSearchParams();
+	if (request.orgId) params.set('orgId', request.orgId);
+	if (request.projectId) params.set('projectId', request.projectId);
+	if (request.agentId) params.set('agentId', request.agentId);
+
+	const queryString = params.toString();
+	const url = `/cli/eval${queryString ? `?${queryString}` : ''}`;
+
+	const resp = await client.request<z.infer<typeof EvalListResponseSchema>>(
+		'GET',
+		url,
+		EvalListResponseSchema
+	);
+
+	if (resp.success) {
+		return resp.data;
+	}
+
+	throw new Error(resp.message || 'Failed to list evaluations');
+}

package/src/services/eval/run-get.ts

@@ -0,0 +1,39 @@
+import { z } from 'zod';
+import { type APIClient, APIResponseSchema } from '../api.ts';
+
+export const EvalRunDetailSchema = z.object({
+	id: z.string().describe('Eval run ID'),
+	sessionId: z.string().describe('Session ID'),
+	evalId: z.string().describe('Evaluation record ID'),
+	evalIdentifier: z.string().nullable().describe('Stable evaluation identifier'),
+	evalName: z.string().nullable().describe('Evaluation name'),
+	agentIdentifier: z.string().nullable().describe('Agent identifier'),
+	projectId: z.string().describe('Project ID'),
+	orgId: z.string().describe('Organization ID'),
+	deploymentId: z.string().nullable().describe('Deployment ID'),
+	devmode: z.boolean().describe('Whether this is a devmode run'),
+	pending: z.boolean().describe('Whether the eval run is pending'),
+	success: z.boolean().describe('Whether the eval run succeeded'),
+	error: z.string().nullable().describe('Error message if failed'),
+	result: z.any().nullable().describe('Eval run result'),
+	createdAt: z.string().describe('Creation timestamp'),
+	updatedAt: z.string().describe('Last updated timestamp'),
+});
+
+export const EvalRunGetResponseSchema = APIResponseSchema(EvalRunDetailSchema);
+
+export type EvalRunDetail = z.infer<typeof EvalRunDetailSchema>;
+
+export async function evalRunGet(client: APIClient, id: string): Promise<EvalRunDetail> {
+	const resp = await client.request<z.infer<typeof EvalRunGetResponseSchema>>(
+		'GET',
+		`/cli/eval-run/${encodeURIComponent(id)}`,
+		EvalRunGetResponseSchema
+	);
+
+	if (resp.success) {
+		return resp.data;
+	}
+
+	throw new Error(resp.message || 'Failed to get eval run');
+}

package/src/services/eval/run-list.ts

@@ -0,0 +1,59 @@
+import { z } from 'zod';
+import { type APIClient, APIResponseSchema } from '../api.ts';
+
+export const EvalRunSchema = z.object({
+	id: z.string().describe('Eval run ID'),
+	sessionId: z.string().describe('Session ID'),
+	evalId: z.string().describe('Evaluation record ID'),
+	evalIdentifier: z.string().nullable().describe('Stable evaluation identifier'),
+	evalName: z.string().nullable().describe('Evaluation name'),
+	agentIdentifier: z.string().nullable().describe('Agent identifier'),
+	projectId: z.string().describe('Project ID'),
+	deploymentId: z.string().nullable().describe('Deployment ID'),
+	devmode: z.boolean().describe('Whether this is a devmode run'),
+	pending: z.boolean().describe('Whether the eval run is pending'),
+	success: z.boolean().describe('Whether the eval run succeeded'),
+	error: z.string().nullable().describe('Error message if failed'),
+	result: z.any().nullable().describe('Eval run result'),
+	createdAt: z.string().describe('Creation timestamp'),
+	updatedAt: z.string().describe('Last updated timestamp'),
+});
+
+export const EvalRunListResponseData = z.array(EvalRunSchema);
+export const EvalRunListResponseSchema = APIResponseSchema(EvalRunListResponseData);
+
+export type EvalRunListItem = z.infer<typeof EvalRunSchema>;
+export type EvalRunListRequest = {
+	projectId?: string;
+	agentId?: string;
+	evalId?: string;
+	sessionId?: string;
+	orgId?: string;
+};
+
+export async function evalRunList(
+	client: APIClient,
+	request: EvalRunListRequest = {}
+): Promise<EvalRunListItem[]> {
+	const params = new URLSearchParams();
+	if (request.orgId) params.set('orgId', request.orgId);
+	if (request.projectId) params.set('projectId', request.projectId);
+	if (request.agentId) params.set('agentId', request.agentId);
+	if (request.evalId) params.set('evalId', request.evalId);
+	if (request.sessionId) params.set('sessionId', request.sessionId);
+
+	const queryString = params.toString();
+	const url = `/cli/eval-run${queryString ? `?${queryString}` : ''}`;
+
+	const resp = await client.request<z.infer<typeof EvalRunListResponseSchema>>(
+		'GET',
+		url,
+		EvalRunListResponseSchema
+	);
+
+	if (resp.success) {
+		return resp.data;
+	}
+
+	throw new Error(resp.message || 'Failed to list eval runs');
+}

package/src/services/exception.ts

@@ -1,11 +1,20 @@
 import { StructuredError } from '../error.ts';
-import type { HttpMethod } from './adapter.ts';
+import { HttpMethodSchema } from './adapter.ts';
+import { z } from 'zod';
 
-export interface ServiceExceptionPayload {
-	statusCode: number;
-	method: HttpMethod;
-	url: string;
-	sessionId?: string | null;
-}
+export const ServiceExceptionPayloadSchema = z
+	.object({
+		statusCode: z.number().describe('HTTP status code returned by the service.'),
+		method: HttpMethodSchema.describe('HTTP method used in the request.'),
+		url: z.string().describe('URL of the failed request.'),
+		sessionId: z
+			.string()
+			.optional()
+			.nullable()
+			.describe('Session ID associated with the request, if any.'),
+	})
+	.describe('Payload for service exception errors.');
+
+export type ServiceExceptionPayload = z.infer<typeof ServiceExceptionPayloadSchema>;
 
 export const ServiceException = StructuredError('ServiceException')<ServiceExceptionPayload>();

package/src/services/index.ts

@@ -1,31 +1,32 @@
 export * from './adapter.ts';
-export * from './evalrun.ts';
+export * from './email/index.ts';
 export * from './exception.ts';
-export * from './keyvalue.ts';
+export * from './keyvalue/index.ts';
 export * from './pagination.ts';
-export * from './sandbox.ts';
-export * from './schedule.ts';
-export * from './session.ts';
-export * from './stream.ts';
-export * from './task.ts';
-export * from './vector.ts';
-export { WebhookService } from './webhook.ts';
-export type {
-	Webhook,
-	WebhookDestination,
-	WebhookReceipt,
-	WebhookDelivery,
-	CreateWebhookParams,
-	UpdateWebhookParams,
-	CreateWebhookDestinationParams,
-	WebhookListResult,
-	WebhookGetResult,
-	WebhookCreateResult,
-	UpdateWebhookResult,
-	CreateDestinationResult,
-	ListDestinationsResult,
-	WebhookReceiptListResult,
-	WebhookDeliveryListResult,
-} from './webhook.ts';
-export * from './email.ts';
-export { buildUrl, toServiceException, toPayload, fromResponse } from './_util.ts';
+export * from './schedule/index.ts';
+export * from './task/index.ts';
+export * from './vector/index.ts';
+
+export * from './config.ts';
+export * from './env.ts';
+export * from './logger.ts';
+export * from './api.ts';
+
+export * from './apikey/index.ts';
+export * from './db/index.ts';
+export * from './eval/index.ts';
+export * from './machine/index.ts';
+export * from './org/index.ts';
+export * from './project/index.ts';
+export * from './queue/index.ts';
+export * from './region/index.ts';
+export * from './sandbox/index.ts';
+export * from './session/index.ts';
+export * from './stats.ts';
+export * from './storage/index.ts';
+export * from './stream/index.ts';
+export * from './thread/index.ts';
+export * from './user/index.ts';
+export * from './webhook/index.ts';
+
+export { buildUrl, fromResponse, toPayload, toServiceException } from './_util.ts';

package/src/services/keyvalue/index.ts

@@ -0,0 +1 @@
+export * from './service.ts';