@agentuity/server 1.0.32 → 1.0.34

package/src/api/services/index.ts

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

package/src/api/services/stats.ts

@@ -1,213 +0,0 @@
-import { z } from 'zod';
-import { type APIClient, APIResponseSchema } from '../api.ts';
-import { StructuredError } from '@agentuity/core';
-
-// --- Error ---
-
-export const ServiceStatsError = StructuredError('ServiceStatsError')<{
-	message: string;
-}>();
-
-// --- Per-Service Stat Schemas ---
-
-export const KeyValueStatSchema = z.object({
-	namespaceCount: z.number(),
-	keyCount: z.number(),
-	totalSizeBytes: z.number(),
-});
-
-export const VectorStatSchema = z.object({
-	namespaceCount: z.number(),
-	documentCount: z.number(),
-	totalSizeBytes: z.number(),
-});
-
-export const QueueStatSchema = z.object({
-	queueCount: z.number(),
-	totalMessages: z.number(),
-	totalDlq: z.number(),
-});
-
-export const StreamStatSchema = z.object({
-	streamCount: z.number(),
-	totalSizeBytes: z.number(),
-});
-
-export const SandboxStatSchema = z.object({
-	totalActive: z.number(),
-	running: z.number(),
-	idle: z.number(),
-	creating: z.number(),
-	totalExecutions: z.number(),
-	totalCpuTimeMs: z.number(),
-	totalMemoryByteSec: z.number(),
-	totalNetworkEgressBytes: z.number(),
-});
-
-export const EmailStatSchema = z.object({
-	addressCount: z.number(),
-	inboundCount: z.number(),
-	outboundCount: z.number(),
-	outboundSuccess: z.number(),
-	outboundFailed: z.number(),
-});
-
-export const TaskStatSchema = z.object({
-	total: z.number().default(0),
-	open: z.number().default(0),
-	inProgress: z.number().default(0),
-	done: z.number().default(0),
-	closed: z.number().default(0),
-	cancelled: z.number().default(0),
-});
-
-export const ScheduleStatSchema = z.object({
-	scheduleCount: z.number(),
-	totalDeliveries: z.number(),
-	successDeliveries: z.number(),
-	failedDeliveries: z.number(),
-});
-
-export const DatabaseStatSchema = z.object({
-	databaseCount: z.number(),
-	totalTableCount: z.number(),
-	totalRecordCount: z.number(),
-	totalSizeBytes: z.number(),
-});
-
-// --- Aggregate Schema ---
-
-export const ServiceStatsDataSchema = z.object({
-	services: z.object({
-		database: DatabaseStatSchema.optional(),
-		keyvalue: KeyValueStatSchema.optional(),
-		vector: VectorStatSchema.optional(),
-		queue: QueueStatSchema.optional(),
-		stream: StreamStatSchema.optional(),
-		sandbox: SandboxStatSchema.optional(),
-		email: EmailStatSchema.optional(),
-		task: TaskStatSchema.optional(),
-		schedule: ScheduleStatSchema.optional(),
-	}),
-});
-
-export const ServiceStatsResponseSchema = APIResponseSchema(ServiceStatsDataSchema);
-
-// --- Types ---
-
-export type KeyValueStat = z.infer<typeof KeyValueStatSchema>;
-export type VectorStat = z.infer<typeof VectorStatSchema>;
-export type QueueStat = z.infer<typeof QueueStatSchema>;
-export type StreamStat = z.infer<typeof StreamStatSchema>;
-export type SandboxStat = z.infer<typeof SandboxStatSchema>;
-export type EmailStat = z.infer<typeof EmailStatSchema>;
-export type TaskStat = z.infer<typeof TaskStatSchema>;
-export type ScheduleStat = z.infer<typeof ScheduleStatSchema>;
-export type DatabaseStat = z.infer<typeof DatabaseStatSchema>;
-export type ServiceStatsData = z.infer<typeof ServiceStatsDataSchema>;
-export type ServiceStatsResponse = z.infer<typeof ServiceStatsResponseSchema>;
-
-// --- Valid Services ---
-
-/**
- * Valid service names that can be used to filter stats.
- */
-export const VALID_SERVICES = [
-	'database',
-	'keyvalue',
-	'email',
-	'vector',
-	'schedule',
-	'task',
-	'stream',
-	'sandbox',
-	'queue',
-] as const;
-
-export type ServiceName = (typeof VALID_SERVICES)[number];
-
-// --- Options ---
-
-export interface ServiceStatsOptions {
-	/**
-	 * Filter to a specific service. If omitted, returns stats for all services.
-	 */
-	service?: ServiceName;
-	/**
-	 * Start time filter (ISO 8601 timestamp).
-	 */
-	start?: string;
-	/**
-	 * End time filter (ISO 8601 timestamp).
-	 */
-	end?: string;
-	/**
-	 * For CLI auth: sets x-agentuity-orgid header.
-	 * Required when using CLI token auth (bearer tokens without embedded org).
-	 */
-	orgIdHeader?: string;
-}
-
-// --- API Function ---
-
-/**
- * Get aggregated stats for services used by an organization.
- *
- * Returns per-service stats with service-specific fields (counts, sizes, etc.).
- * Services that error on the backend are omitted from the response.
- * Services with no provisioned tenant DB return zero values.
- *
- * @param client - The API client instance
- * @param orgId - The organization ID
- * @param options - Optional filtering (service, time range)
- * @returns Service stats data with per-service breakdown
- * @throws {ServiceStatsError} If the API request fails
- *
- * @example
- * ```typescript
- * // Get stats for all services
- * const stats = await getServiceStats(client, 'org_123');
- * console.log(`KV keys: ${stats.services.keyvalue?.keyCount}`);
- * ```
- *
- * @example
- * ```typescript
- * // Get stats for a specific service
- * const stats = await getServiceStats(client, 'org_123', {
- *   service: 'keyvalue',
- * });
- * ```
- */
-export async function getServiceStats(
-	client: APIClient,
-	orgId: string,
-	options?: ServiceStatsOptions
-): Promise<ServiceStatsData> {
-	const params = new URLSearchParams();
-	if (options?.service) params.set('service', options.service);
-	if (options?.start) params.set('start', options.start);
-	if (options?.end) params.set('end', options.end);
-
-	const queryString = params.toString();
-	const url = `/services/stats/2026-02-26/${encodeURIComponent(orgId)}${queryString ? `?${queryString}` : ''}`;
-
-	const headers: Record<string, string> = {};
-	if (options?.orgIdHeader) {
-		headers['x-agentuity-orgid'] = options.orgIdHeader;
-	}
-
-	const resp = await client.get(
-		url,
-		ServiceStatsResponseSchema,
-		undefined,
-		Object.keys(headers).length > 0 ? headers : undefined
-	);
-
-	if (resp.success) {
-		return resp.data;
-	}
-
-	throw new ServiceStatsError({
-		message: resp.message || 'Failed to get service stats',
-	});
-}

package/src/api/session/get.ts

@@ -1,106 +0,0 @@
-import { z } from 'zod';
-import { APIClient, APIResponseSchema } from '../api.ts';
-import { SessionSchema, type Session } from './list.ts';
-import { SessionResponseError } from './util.ts';
-
-export const _SessionGetRequestSchema = z.object({
-	id: z.string().describe('the session id'),
-});
-
-export const SessionEvalRunSchema = z.object({
-	id: z.string().describe('eval run id'),
-	created_at: z.string().describe('creation timestamp'),
-	eval_id: z.string().describe('evaluation id'),
-	pending: z.boolean().describe('pending status'),
-	success: z.boolean().describe('success status'),
-	error: z.string().nullable().describe('error message'),
-	result: z.record(z.string(), z.unknown()).nullable().describe('result object'),
-});
-
-export interface SpanNode {
-	id: string;
-	duration: number;
-	operation: string;
-	attributes: Record<string, unknown>;
-	children?: SpanNode[];
-	error?: string;
-}
-
-export const SpanNodeSchema: z.ZodType<SpanNode> = z.lazy(() =>
-	z.object({
-		id: z.string().describe('span ID'),
-		duration: z.number().describe('duration in milliseconds'),
-		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'),
-	})
-);
-
-export const RouteInfoSchema = z
-	.object({
-		id: z.string().describe('route id'),
-		method: z.string().describe('HTTP method'),
-		path: z.string().describe('route path'),
-	})
-	.nullable();
-
-export const AgentInfoSchema = z.object({
-	name: z.string().describe('agent name'),
-	identifier: z.string().describe('agent identifier'),
-});
-
-export const EnrichedSessionDataSchema = z.object({
-	session: SessionSchema,
-	agents: z.array(AgentInfoSchema).describe('resolved agents'),
-	eval_runs: z.array(SessionEvalRunSchema).describe('eval runs for this session'),
-	route: RouteInfoSchema.describe('route information'),
-});
-
-export const SessionGetResponseSchema = APIResponseSchema(EnrichedSessionDataSchema);
-
-type SessionGetRequest = z.infer<typeof _SessionGetRequestSchema>;
-type SessionGetResponse = z.infer<typeof SessionGetResponseSchema>;
-
-/**
- * Get a single session by id
- *
- * @param client
- * @param request
- * @returns
- */
-export type SessionEvalRun = z.infer<typeof SessionEvalRunSchema>;
-/** @deprecated Use SessionEvalRun instead */
-export type EvalRun = SessionEvalRun;
-export type RouteInfo = z.infer<typeof RouteInfoSchema>;
-export type AgentInfo = z.infer<typeof AgentInfoSchema>;
-export type EnrichedSession = {
-	session: Session;
-	agents: AgentInfo[];
-	evalRuns: SessionEvalRun[];
-	timeline: SpanNode | null;
-	route: RouteInfo;
-};
-
-export async function sessionGet(
-	client: APIClient,
-	request: SessionGetRequest
-): Promise<EnrichedSession> {
-	const resp = await client.request<SessionGetResponse>(
-		'GET',
-		`/session/2025-03-17/${request.id}`,
-		SessionGetResponseSchema
-	);
-
-	if (resp.success) {
-		return {
-			session: resp.data.session,
-			agents: resp.data.agents,
-			evalRuns: resp.data.eval_runs,
-			timeline: (resp.data.session.timeline as SpanNode) ?? null,
-			route: resp.data.route,
-		};
-	}
-
-	throw new SessionResponseError({ message: resp.message });
-}

package/src/api/session/index.ts

@@ -1,3 +0,0 @@
-export * from './get.ts';
-export * from './list.ts';
-export * from './logs.ts';

package/src/api/session/list.ts

@@ -1,136 +0,0 @@
-import type { SortDirection } from '@agentuity/core';
-import { z } from 'zod';
-import { APIClient, APIResponseSchema } from '../api.ts';
-import { SessionResponseError } from './util.ts';
-
-const SessionSchema = z.object({
-	id: z.string().describe('the session id'),
-	created_at: z.string().describe('the creation timestamp'),
-	updated_at: z.string().describe('the last update timestamp'),
-	deleted: z.boolean().describe('whether the session is deleted'),
-	deleted_at: z.string().nullable().describe('the deletion timestamp'),
-	deleted_by: z.string().nullable().describe('who deleted the session'),
-	start_time: z.string().describe('the session start time'),
-	end_time: z.string().nullable().describe('the session end time'),
-	duration: z.number().nullable().describe('the session duration in nanoseconds'),
-	org_id: z.string().describe('the organization id'),
-	project_id: z.string().describe('the project id'),
-	deployment_id: z.string().describe('the deployment id'),
-	agent_ids: z.array(z.string()).describe('the agent ids involved'),
-	trigger: z.string().describe('how the session was triggered'),
-	env: z.string().describe('the environment'),
-	devmode: z.boolean().describe('whether dev mode was enabled'),
-	pending: z.boolean().describe('whether the session is pending'),
-	success: z.boolean().describe('whether the session succeeded'),
-	error: z.string().nullable().describe('the error message if failed'),
-	metadata: z
-		.record(z.string(), z.unknown())
-		.nullable()
-		.optional()
-		.describe('unencrypted key-value metadata'),
-	cpu_time: z.number().nullable().describe('the CPU time in nanoseconds'),
-	llm_cost: z.number().nullable().describe('the LLM cost'),
-	llm_prompt_token_count: z.number().nullable().describe('the LLM prompt token count'),
-	llm_completion_token_count: z.number().nullable().describe('the LLM completion token count'),
-	total_cost: z.number().nullable().describe('the total cost'),
-	method: z.string().nullable().describe('the HTTP method'),
-	url: z.string().nullable().describe('the request URL'),
-	route_id: z.string().nullable().describe('the route id'),
-	thread_id: z.string().nullable().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 };
-
-export const SessionListResponse = z.array(SessionSchema);
-
-export const SessionListResponseSchema = APIResponseSchema(SessionListResponse);
-
-export type SessionListResponse = z.infer<typeof SessionListResponseSchema>;
-export type SessionList = z.infer<typeof SessionListResponse>;
-export type Session = z.infer<typeof SessionSchema>;
-
-export type SessionSortField = 'created' | 'updated' | 'duration' | 'startTime';
-
-export interface SessionListOptions {
-	/** @deprecated Use `limit` instead. Will be removed in a future version. */
-	count?: number;
-	limit?: number;
-	offset?: number;
-	sort?: SessionSortField;
-	direction?: SortDirection;
-	orgId?: string;
-	projectId?: string;
-	deploymentId?: string;
-	trigger?: string;
-	env?: string;
-	devmode?: boolean;
-	success?: boolean;
-	threadId?: string;
-	agentIdentifier?: string;
-	startAfter?: string;
-	startBefore?: string;
-	metadata?: Record<string, unknown>;
-}
-
-/**
- * List sessions
- *
- * @param client
- * @param options filtering and pagination options
- * @returns
- */
-export async function sessionList(
-	client: APIClient,
-	options: SessionListOptions = {}
-): Promise<SessionList> {
-	const {
-		count,
-		limit,
-		offset,
-		sort,
-		direction,
-		orgId,
-		projectId,
-		deploymentId,
-		trigger,
-		env,
-		devmode,
-		success,
-		threadId,
-		agentIdentifier,
-		startAfter,
-		startBefore,
-		metadata,
-	} = options;
-	const resolvedLimit = limit ?? count ?? 10;
-	const params = new URLSearchParams({ limit: resolvedLimit.toString() });
-	if (orgId) params.set('orgId', orgId);
-	if (projectId) params.set('projectId', projectId);
-	if (deploymentId) params.set('deploymentId', deploymentId);
-	if (trigger) params.set('trigger', trigger);
-	if (env) params.set('env', env);
-	if (offset !== undefined) params.set('offset', offset.toString());
-	if (sort) params.set('sort', sort);
-	if (direction) params.set('direction', direction);
-	if (devmode !== undefined) params.set('devmode', devmode.toString());
-	if (success !== undefined) params.set('success', success.toString());
-	if (threadId) params.set('threadId', threadId);
-	if (agentIdentifier) params.set('agentIdentifier', agentIdentifier);
-	if (startAfter) params.set('startAfter', startAfter);
-	if (startBefore) params.set('startBefore', startBefore);
-	if (metadata) params.set('metadata', JSON.stringify(metadata));
-
-	const resp = await client.request<SessionListResponse>(
-		'GET',
-		`/session/2025-03-17?${params.toString()}`,
-		SessionListResponseSchema
-	);
-
-	if (resp.success) {
-		return resp.data;
-	}
-
-	throw new SessionResponseError({ message: resp.message });
-}

package/src/api/session/logs.ts

@@ -1,47 +0,0 @@
-import { z } from 'zod';
-import { APIClient, APIResponseSchema } from '../api.ts';
-import { SessionResponseError } from './util.ts';
-
-export const _SessionLogsRequestSchema = z.object({
-	id: z.string().describe('the session id'),
-});
-
-export const LogSchema = z.object({
-	body: z.string().describe('the log body'),
-	severity: z.string().describe('the log severity'),
-	timestamp: z.string().describe('the log timestamp'),
-});
-
-export const SessionLogsResponse = z.array(LogSchema);
-
-export const SessionLogsResponseSchema = APIResponseSchema(SessionLogsResponse);
-
-type SessionLogsRequest = z.infer<typeof _SessionLogsRequestSchema>;
-type SessionLogsResponse = z.infer<typeof SessionLogsResponseSchema>;
-
-export type SessionLog = z.infer<typeof LogSchema>;
-export type SessionLogs = SessionLog[];
-
-/**
- * Get logs for a session from the App API
- *
- * @param client APIClient configured for the App API base URL
- * @param request
- * @returns
- */
-export async function sessionLogs(
-	client: APIClient,
-	request: SessionLogsRequest
-): Promise<SessionLogs> {
-	const resp = await client.request<SessionLogsResponse>(
-		'GET',
-		`/cli/session/${request.id}/logs`,
-		SessionLogsResponseSchema
-	);
-
-	if (resp.success) {
-		return resp.data;
-	}
-
-	throw new SessionResponseError({ message: resp.message });
-}

package/src/api/session/util.ts

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

package/src/api/storage/config.ts

@@ -1,111 +0,0 @@
-import { z } from 'zod';
-import { type APIClient, APIResponseSchema, APIResponseSchemaNoData } from '../api.ts';
-import {
-	BucketConfigSchema,
-	BucketConfigUpdateSchema,
-	type BucketConfig,
-	type BucketConfigUpdate,
-} from './types.ts';
-import { API_VERSION, BucketConfigResponseError } from './util.ts';
-
-export const BucketConfigGetResponseSchema = APIResponseSchema(BucketConfigSchema);
-export const BucketConfigUpdateResponseSchema = APIResponseSchema(BucketConfigSchema);
-export const BucketConfigDeleteResponseSchema = APIResponseSchemaNoData();
-
-/**
- * Get the configuration for a bucket.
- * Returns the current config with null for any fields using system defaults.
- *
- * @param client - The API client to use for the request
- * @param bucketName - Name of the bucket to get config for
- * @param extraHeaders - Optional extra headers (e.g. x-agentuity-orgid for CLI auth)
- * @returns The bucket configuration
- * @throws {BucketConfigResponseError} If the request fails
- */
-export async function getBucketConfig(
-	client: APIClient,
-	bucketName: string,
-	extraHeaders?: Record<string, string>
-): Promise<BucketConfig> {
-	const url = `/bucket/config/${API_VERSION}/${encodeURIComponent(bucketName)}`;
-
-	const resp = await client.get<z.infer<typeof BucketConfigGetResponseSchema>>(
-		url,
-		BucketConfigGetResponseSchema,
-		undefined,
-		extraHeaders
-	);
-
-	if (resp.success) {
-		return resp.data;
-	}
-
-	throw new BucketConfigResponseError({ message: resp.message });
-}
-
-/**
- * Update (upsert) bucket configuration.
- * Partial update: only fields present in the request are changed.
- * Send null for a field to reset it to system default.
- * Omit a field to leave it unchanged.
- *
- * @param client - The API client to use for the request
- * @param bucketName - Name of the bucket to update config for
- * @param config - Partial config update (fields to set, null to unset, omit to leave)
- * @param extraHeaders - Optional extra headers (e.g. x-agentuity-orgid for CLI auth)
- * @returns The updated bucket configuration
- * @throws {BucketConfigResponseError} If the request fails
- */
-export async function updateBucketConfig(
-	client: APIClient,
-	bucketName: string,
-	config: BucketConfigUpdate,
-	extraHeaders?: Record<string, string>
-): Promise<BucketConfig> {
-	const url = `/bucket/config/${API_VERSION}/${encodeURIComponent(bucketName)}`;
-
-	const resp = await client.put<
-		z.infer<typeof BucketConfigUpdateResponseSchema>,
-		BucketConfigUpdate
-	>(
-		url,
-		config,
-		BucketConfigUpdateResponseSchema,
-		BucketConfigUpdateSchema,
-		undefined,
-		extraHeaders
-	);
-
-	if (resp.success) {
-		return resp.data;
-	}
-
-	throw new BucketConfigResponseError({ message: resp.message });
-}
-
-/**
- * Delete all custom configuration for a bucket (reset to system defaults).
- *
- * @param client - The API client to use for the request
- * @param bucketName - Name of the bucket to reset config for
- * @param extraHeaders - Optional extra headers (e.g. x-agentuity-orgid for CLI auth)
- * @throws {BucketConfigResponseError} If the request fails
- */
-export async function deleteBucketConfig(
-	client: APIClient,
-	bucketName: string,
-	extraHeaders?: Record<string, string>
-): Promise<void> {
-	const url = `/bucket/config/${API_VERSION}/${encodeURIComponent(bucketName)}`;
-
-	const resp = await client.delete<z.infer<typeof BucketConfigDeleteResponseSchema>>(
-		url,
-		BucketConfigDeleteResponseSchema,
-		undefined,
-		extraHeaders
-	);
-
-	if (!resp.success) {
-		throw new BucketConfigResponseError({ message: resp.message });
-	}
-}

package/src/api/storage/index.ts

@@ -1,4 +0,0 @@
-export * from './config.ts';
-export * from './objects.ts';
-export * from './types.ts';
-export { BucketConfigResponseError, StorageObjectsResponseError } from './util.ts';