@agentuity/core 1.0.33 → 1.0.34

package/src/api/org/resources.ts

@@ -1,140 +0,0 @@
-import type { SortDirection } from '../../services/pagination.ts';
-import { z } from 'zod';
-import { APIResponseSchema, APIClient } from '../api.ts';
-import { OrgResourceResponseError } from './util.ts';
-
-export const OrgS3Resource = z.object({
-	bucket_name: z.string().describe('the S3 bucket name'),
-	access_key: z.string().nullable().optional().describe('the S3 access key'),
-	secret_key: z.string().nullable().optional().describe('the S3 secret key'),
-	region: z.string().nullable().optional().describe('the S3 region'),
-	endpoint: z.string().nullable().optional().describe('the S3 endpoint'),
-	cloud_region: z.string().describe('the cloud region where this resource is provisioned'),
-	org_id: z.string().describe('the organization ID that owns this resource'),
-	org_name: z.string().describe('the organization name that owns this resource'),
-	bucket_type: z.string().describe('the bucket type (user or snapshots)'),
-	internal: z.boolean().describe('whether this is a system-managed bucket'),
-	description: z.string().nullable().optional().describe('optional description of the bucket'),
-	object_count: z
-		.number()
-		.int()
-		.nonnegative()
-		.optional()
-		.describe('number of objects in this bucket'),
-	total_size: z.number().int().nonnegative().optional().describe('total size of objects in bytes'),
-	last_event_at: z.string().optional().describe('last activity timestamp (ISO8601)'),
-});
-
-export const OrgDBResource = z.object({
-	name: z.string().describe('the database name'),
-	description: z.string().nullable().optional().describe('optional description of the database'),
-	username: z.string().nullable().optional().describe('the database username'),
-	password: z.string().nullable().optional().describe('the database password'),
-	url: z.string().nullable().optional().describe('the full database connection URL'),
-	cloud_region: z.string().describe('the cloud region where this resource is provisioned'),
-	org_id: z.string().describe('the organization ID that owns this resource'),
-	org_name: z.string().describe('the organization name that owns this resource'),
-	internal: z.boolean().describe('whether this is a system-managed database (KV/Vector/Queue)'),
-});
-
-export const OrgResourceListResponse = z.object({
-	s3: z.array(OrgS3Resource),
-	db: z.array(OrgDBResource),
-});
-
-export const OrgResourceListResponseSchema = APIResponseSchema(OrgResourceListResponse);
-
-export type OrgResourceListResponse = z.infer<typeof OrgResourceListResponseSchema>;
-export type OrgResourceList = z.infer<typeof OrgResourceListResponse>;
-export type OrgS3Resource = z.infer<typeof OrgS3Resource>;
-export type OrgDBResource = z.infer<typeof OrgDBResource>;
-
-export type ResourceSortField = 'name' | 'created' | 'region';
-
-export interface ListOrgResourcesOptions {
-	/** Filter by resource type (default: "all") */
-	type?: 'all' | 's3' | 'db';
-	/** Filter by resource name substring */
-	name?: string;
-	/** Organization ID (required for CLI auth, extracted from context for SDK auth) */
-	orgId?: string;
-	/** Maximum number of resources to return */
-	limit?: number;
-	/** Number of resources to skip for pagination */
-	offset?: number;
-	/** Field to sort by */
-	sort?: ResourceSortField;
-	/** Sort direction (default: 'desc') */
-	direction?: SortDirection;
-}
-
-/**
- * List all resources for the authenticated organization (across all regions)
- *
- * @param client - Catalyst API client (must be authenticated)
- * @param options - Optional filters including orgId for CLI auth
- * @returns List of S3 and DB resources with their cloud regions
- *
- * @example
- * // Get all resources (SDK auth - orgId from context)
- * const all = await listOrgResources(client);
- *
- * @example
- * // Get all resources (CLI auth - orgId required)
- * const all = await listOrgResources(client, { orgId: 'org_123' });
- *
- * @example
- * // Get only S3 buckets
- * const s3Only = await listOrgResources(client, { type: 's3', orgId: 'org_123' });
- *
- * @example
- * // Get only DBs
- * const dbsOnly = await listOrgResources(client, { type: 'db', orgId: 'org_123' });
- */
-export async function listOrgResources(
-	client: APIClient,
-	options?: ListOrgResourcesOptions
-): Promise<OrgResourceList> {
-	const params = new URLSearchParams();
-	if (options?.type && options.type !== 'all') {
-		params.set('type', options.type);
-	}
-	if (options?.name) {
-		params.set('name', options.name);
-	}
-	if (options?.limit !== undefined) {
-		params.set('limit', options.limit.toString());
-	}
-	if (options?.offset !== undefined) {
-		params.set('offset', options.offset.toString());
-	}
-	if (options?.sort) {
-		params.set('sort', options.sort);
-	}
-	if (options?.direction) {
-		params.set('direction', options.direction);
-	}
-
-	const query = params.toString();
-	const url = `/resource${query ? `?${query}` : ''}`;
-
-	// Build headers - include orgId for CLI auth
-	const headers: Record<string, string> = {};
-	if (options?.orgId) {
-		headers['x-agentuity-orgid'] = options.orgId;
-	}
-
-	const resp = await client.request<OrgResourceListResponse>(
-		'GET',
-		url,
-		OrgResourceListResponseSchema,
-		undefined,
-		undefined,
-		undefined,
-		headers
-	);
-	if (resp.success) {
-		return resp.data;
-	}
-	throw new OrgResourceResponseError({ message: resp.message });
-}

package/src/api/project/delete.ts

@@ -1,25 +0,0 @@
-import { z } from 'zod';
-import { type APIClient, APIResponseSchema } from '../api.ts';
-import { ProjectResponseError } from './util.ts';
-
-export const ProjectDeleteRequestSchema = z.object({ ids: z.array(z.string()) });
-export const ProjectDeleteResponseSchema = APIResponseSchema(z.array(z.string()));
-
-type ProjectDeleteRequest = z.infer<typeof ProjectDeleteRequestSchema>;
-type ProjectDeleteResponse = z.infer<typeof ProjectDeleteResponseSchema>;
-
-export async function projectDelete(client: APIClient, ...ids: string[]): Promise<string[]> {
-	const resp = await client.request<ProjectDeleteResponse, ProjectDeleteRequest>(
-		'DELETE',
-		'/cli/project',
-		ProjectDeleteResponseSchema,
-		{ ids },
-		ProjectDeleteRequestSchema
-	);
-
-	if (resp.success) {
-		return resp.data;
-	}
-
-	throw new ProjectResponseError({ message: resp.message ?? 'failed to delete project' });
-}

package/src/api/project/deploy.ts

@@ -1,458 +0,0 @@
-import { z } from 'zod';
-import { type APIClient, APIResponseSchema } from '../api.ts';
-import { ProjectResponseError } from './util.ts';
-
-export const Resources = z.object({
-	memory: z.string().default('500Mi').describe('The memory requirements'),
-	cpu: z.string().default('500m').describe('The CPU requirements'),
-	disk: z.string().default('500Mi').describe('The disk requirements'),
-});
-
-export const Mode = z.object({
-	type: z
-		.enum(['on-demand', 'provisioned'])
-		.default('on-demand')
-		.describe('on-demand or provisioned'),
-	idle: z.string().optional().describe('duration in seconds if on-demand'),
-});
-
-export const ProjectBuildConfig = z.object({
-	timeout: z.string().optional().describe('Build execution timeout (e.g. "30m")'),
-	resources: z
-		.object({
-			memory: z.string().optional().describe('Build sandbox memory (e.g. "4Gi")'),
-			cpu: z.string().optional().describe('Build sandbox CPU (e.g. "2")'),
-			disk: z.string().optional().describe('Build sandbox disk (e.g. "4Gi")'),
-		})
-		.optional()
-		.describe('Build sandbox resource limits'),
-});
-
-export const DeploymentConfig = z.object({
-	resources: Resources.optional().describe('the resource requirements for your deployed project'),
-	mode: Mode.optional().describe('the provisioning mode for the project'),
-	dependencies: z
-		.array(z.string().describe('APT dependencies to install prior to launching your project'))
-		.optional(),
-	domains: z.array(z.string().describe('the custom domain')).optional(),
-});
-
-const BaseFileFields = {
-	filename: z.string().describe('the relative path for the file'),
-	version: z.string().describe('the SHA256 content of the file'),
-};
-
-export const BuildEvalSchema = z.object({
-	...BaseFileFields,
-	id: z.string().describe('the unique calculated id for the eval'),
-	identifier: z.string().describe('the unique id for eval for the project across deployments'),
-	name: z.string().describe('the name of the eval'),
-	description: z.string().optional().describe('the eval description'),
-	agentIdentifier: z.string().describe('the identifier of the agent'),
-	projectId: z.string().describe('the project id'),
-});
-
-const BaseAgentFields = {
-	...BaseFileFields,
-	id: z.string().describe('the unique calculated id for the agent'),
-	agentId: z.string().describe('the unique id for agent for the project across deployments'),
-	projectId: z.string().describe('the project id'),
-	name: z.string().describe('the name of the agent'),
-	description: z.string().optional().describe('the agent description'),
-	evals: z.array(BuildEvalSchema).optional().describe('the evals for the agent'),
-	schema: z
-		.object({
-			input: z.string().optional().describe('JSON schema for input (stringified JSON)'),
-			output: z.string().optional().describe('JSON schema for output (stringified JSON)'),
-		})
-		.optional()
-		.describe('input and output JSON schemas for the agent'),
-};
-
-export const BuildAgentSchema = z.object({
-	...BaseAgentFields,
-});
-
-export const BuildMetadataSchema = z.object({
-	routes: z.array(
-		z.object({
-			id: z.string().describe('the unique calculated id for the route'),
-			filename: z.string().describe('the relative path for the file'),
-			path: z.string().describe('the route path'),
-			method: z.enum(['get', 'post', 'put', 'delete', 'patch']).describe('the HTTP method'),
-			version: z.string().describe('the SHA256 content of the file'),
-			type: z.enum(['api', 'sms', 'email', 'cron', 'websocket', 'sse', 'stream']),
-			agentIds: z
-				.array(z.string())
-				.optional()
-				.describe('the agent ids associated with this route'),
-			config: z
-				.record(z.string(), z.unknown())
-				.optional()
-				.describe('type specific configuration'),
-			schema: z
-				.object({
-					input: z.string().optional().describe('JSON schema for input (stringified JSON)'),
-					output: z.string().optional().describe('JSON schema for output (stringified JSON)'),
-				})
-				.optional()
-				.describe('input and output JSON schemas for the route'),
-		})
-	),
-	agents: z.array(BuildAgentSchema),
-	assets: z.array(
-		z.object({
-			filename: z.string().describe('the relative path for the file'),
-			kind: z.string().describe('the type of asset'),
-			contentType: z.string().describe('the content-type for the file'),
-			contentEncoding: z.string().optional().describe('the content-encoding for the file'),
-			size: z.number().describe('the size in bytes for the file'),
-		})
-	),
-	project: z.object({
-		id: z.string().describe('the project id'),
-		name: z.string().describe('the name of the project (from package.json)'),
-		version: z.string().optional().describe('the version of the project (from package.json)'),
-		description: z
-			.string()
-			.optional()
-			.describe('the description of the project (from package.json)'),
-		keywords: z.array(z.string()).optional().describe('the keywords from package.json'),
-		orgId: z.string().describe('the organization id for the project'),
-	}),
-	deployment: z.intersection(
-		DeploymentConfig,
-		z.object({
-			id: z.string().describe('the deployment id'),
-			date: z.string().describe('the date the deployment was created in UTC format'),
-			git: z
-				.object({
-					repo: z.string().optional().describe('the repository name'),
-					commit: z.string().optional().describe('the git commit sha'),
-					message: z.string().optional().describe('the git commit message'),
-					branch: z.string().optional().describe('the git branch'),
-					tags: z.array(z.string()).optional().describe('the tags for the current branch'),
-					pr: z.string().optional().describe('the pull request number'),
-					provider: z.string().optional().describe('the CI provider'),
-					trigger: z
-						.string()
-						.default('cli')
-						.optional()
-						.describe('the trigger that caused the build'),
-					url: z
-						.string()
-						.url()
-						.optional()
-						.describe('the url to the commit for the CI provider'),
-					buildUrl: z
-						.string()
-						.url()
-						.optional()
-						.describe('the url to the build for the CI provider'),
-					event: z
-						.enum(['pull_request', 'push', 'manual', 'workflow'])
-						.default('manual')
-						.optional()
-						.describe(
-							'The type of Git-related event that triggered the deployment: pull_request (A pull request or merge request was opened, updated, or merged), push (A commit was pushed directly to a branch), manual (A deployment was triggered manually via CLI or a button), workflow (A deployment was triggered by an automated workflow, such as a CI pipeline)'
-						),
-					pull_request: z
-						.object({
-							number: z.number(),
-							url: z.string().optional(),
-						})
-						.optional()
-						.describe(
-							'This is only present when the deployment was triggered via a pull request.'
-						),
-				})
-				.optional()
-				.describe('git commit information'),
-			build: z.object({
-				bun: z.string().describe('the version of bun that was used to build the deployment'),
-				agentuity: z.string().describe('the version of the agentuity runtime'),
-				arch: z.string().describe('the machine architecture'),
-				platform: z.string().describe('the machine os platform'),
-			}),
-		})
-	),
-});
-
-export type BuildMetadata = z.infer<typeof BuildMetadataSchema>;
-
-export const CreateProjectDeploymentSchema = z.object({
-	id: z.string().describe('the unique id for the deployment'),
-	orgId: z.string().describe('the organization id'),
-	publicKey: z.string().describe('the public key to use for encrypting the deployment'),
-	buildLogsStreamURL: z
-		.string()
-		.optional()
-		.describe('the URL for streaming build logs (PUT to write, GET to read)'),
-});
-
-export const CreateProjectDeploymentResponseSchema = APIResponseSchema(
-	CreateProjectDeploymentSchema
-);
-
-type CreateProjectDeploymentPayload = z.infer<typeof CreateProjectDeploymentResponseSchema>;
-
-export type Deployment = z.infer<typeof CreateProjectDeploymentSchema>;
-
-/**
- * Create a new project deployment
- *
- * @param client
- * @param projectId
- * @returns
- */
-export async function projectDeploymentCreate(
-	client: APIClient,
-	projectId: string,
-	deploymentConfig?: z.infer<typeof DeploymentConfig>
-): Promise<Deployment> {
-	const resp = await client.request<CreateProjectDeploymentPayload>(
-		'POST',
-		`/cli/deploy/2/start/${projectId}`,
-		CreateProjectDeploymentResponseSchema,
-		deploymentConfig ?? {}
-	);
-	if (resp.success) {
-		return resp.data;
-	}
-	throw new ProjectResponseError({ message: resp.message });
-}
-
-export const DeploymentInstructionsSchema = z.object({
-	deployment: z.string().describe('the url for uploading the encrypted deployment archive'),
-	assets: z
-		.record(
-			z.string().describe('the asset id'),
-			z.string().describe('the url for the asset upload')
-		)
-		.describe('the upload metadata for public assets'),
-});
-
-export const DeploymentInstructionsResponseSchema = APIResponseSchema(DeploymentInstructionsSchema);
-
-type DeploymentInstructionsResponse = z.infer<typeof DeploymentInstructionsResponseSchema>;
-export type DeploymentInstructions = z.infer<typeof DeploymentInstructionsSchema>;
-
-/**
- * Update the deployment with the build metadata
- *
- * @param client
- * @param deploymentId
- * @returns
- */
-export async function projectDeploymentUpdate(
-	client: APIClient,
-	deploymentId: string,
-	deployment: BuildMetadata,
-	signal?: AbortSignal
-): Promise<DeploymentInstructions> {
-	const resp = await client.request<DeploymentInstructionsResponse, BuildMetadata>(
-		'PUT',
-		`/cli/deploy/2/start/${deploymentId}`,
-		DeploymentInstructionsResponseSchema,
-		deployment,
-		BuildMetadataSchema,
-		signal
-	);
-	if (resp.success) {
-		return resp.data;
-	}
-	throw new ProjectResponseError({ message: resp.message });
-}
-
-export const DeploymentCompleteSchema = z.object({
-	streamId: z.string().optional().describe('the stream id for warmup logs'),
-	publicUrls: z
-		.object({
-			latest: z.string().url().describe('the public url for the latest deployment'),
-			deployment: z.string().url().describe('the public url for this deployment'),
-			custom: z.array(z.string().describe('the custom domain')),
-			vanityDeployment: z
-				.string()
-				.url()
-				.nullable()
-				.optional()
-				.describe('the vanity url for this deployment'),
-			vanityProject: z
-				.string()
-				.url()
-				.nullable()
-				.optional()
-				.describe('the vanity url for the latest deployment'),
-		})
-		.describe('the map of public urls'),
-});
-
-export const DeploymentCompleteResponseSchema = APIResponseSchema(DeploymentCompleteSchema);
-
-type DeploymentCompleteResponse = z.infer<typeof DeploymentCompleteResponseSchema>;
-export type DeploymentComplete = z.infer<typeof DeploymentCompleteSchema>;
-
-export const DeploymentStateValue = z.enum([
-	'pending',
-	'building',
-	'deploying',
-	'failed',
-	'completed',
-]);
-
-export type DeploymentState = z.infer<typeof DeploymentStateValue>;
-
-export const DeploymentStatusSchema = z.object({
-	state: DeploymentStateValue.describe('the current deployment state'),
-});
-
-export const DeploymentStatusResponseSchema = APIResponseSchema(DeploymentStatusSchema);
-
-type DeploymentStatusResponse = z.infer<typeof DeploymentStatusResponseSchema>;
-export type DeploymentStatusResult = z.infer<typeof DeploymentStatusSchema>;
-
-/**
- * Complete the deployment once build is uploaded
- *
- * @param client
- * @param deploymentId
- * @returns
- */
-export async function projectDeploymentComplete(
-	client: APIClient,
-	deploymentId: string,
-	signal?: AbortSignal
-): Promise<DeploymentComplete> {
-	const resp = await client.request<DeploymentCompleteResponse>(
-		'POST',
-		`/cli/deploy/2/complete/${deploymentId}`,
-		DeploymentCompleteResponseSchema,
-		undefined,
-		undefined,
-		signal
-	);
-	if (resp.success) {
-		return resp.data;
-	}
-	throw new ProjectResponseError({
-		message: resp.message || 'Deployment completion failed with unknown error',
-	});
-}
-
-/**
- * Get the current provisioning status of a deployment
- *
- * @param client
- * @param deploymentId
- * @returns
- */
-export async function projectDeploymentStatus(
-	client: APIClient,
-	deploymentId: string,
-	signal?: AbortSignal
-): Promise<DeploymentStatusResult> {
-	const resp = await client.request<DeploymentStatusResponse>(
-		'GET',
-		`/cli/deploy/2/status/${deploymentId}`,
-		DeploymentStatusResponseSchema,
-		undefined,
-		undefined,
-		signal
-	);
-	if (resp.success) {
-		return resp.data;
-	}
-	throw new ProjectResponseError({ message: resp.message });
-}
-
-export interface ClientDiagnosticsError {
-	type: 'file' | 'general';
-	scope: 'typescript' | 'ast' | 'build' | 'bundler' | 'validation' | 'deploy';
-	path?: string;
-	line?: number;
-	column?: number;
-	message: string;
-	code?: string;
-}
-
-export interface ClientDiagnosticsTiming {
-	name: string;
-	startedAt: string;
-	completedAt: string;
-	durationMs: number;
-}
-
-export interface ClientDiagnostics {
-	success: boolean;
-	errors: ClientDiagnosticsError[];
-	warnings: ClientDiagnosticsError[];
-	diagnostics: ClientDiagnosticsTiming[];
-	error?: string;
-}
-
-export interface DeploymentFailPayload {
-	error?: string;
-	diagnostics?: ClientDiagnostics;
-}
-
-export const ClientDiagnosticsErrorSchema = z.object({
-	type: z.enum(['file', 'general']),
-	scope: z.enum(['typescript', 'ast', 'build', 'bundler', 'validation', 'deploy']),
-	path: z.string().optional(),
-	line: z.number().optional(),
-	column: z.number().optional(),
-	message: z.string(),
-	code: z.string().optional(),
-});
-
-export const ClientDiagnosticsTimingSchema = z.object({
-	name: z.string(),
-	startedAt: z.string(),
-	completedAt: z.string(),
-	durationMs: z.number(),
-});
-
-export const ClientDiagnosticsSchema = z.object({
-	success: z.boolean(),
-	errors: z.array(ClientDiagnosticsErrorSchema),
-	warnings: z.array(ClientDiagnosticsErrorSchema),
-	diagnostics: z.array(ClientDiagnosticsTimingSchema),
-	error: z.string().optional(),
-});
-
-export const DeploymentFailPayloadSchema = z.object({
-	error: z.string().optional(),
-	diagnostics: ClientDiagnosticsSchema.optional(),
-});
-
-export const DeploymentFailResponseSchema = z.object({
-	state: z.literal('failed'),
-});
-
-export const DeploymentFailAPIResponseSchema = APIResponseSchema(DeploymentFailResponseSchema);
-type DeploymentFailResponse = z.infer<typeof DeploymentFailAPIResponseSchema>;
-
-/**
- * Report a deployment failure from the client
- *
- * @param client
- * @param deploymentId
- * @param payload - Error message and/or structured diagnostics
- * @returns
- */
-export async function projectDeploymentFail(
-	client: APIClient,
-	deploymentId: string,
-	payload: DeploymentFailPayload
-): Promise<void> {
-	const resp = await client.request<DeploymentFailResponse, DeploymentFailPayload>(
-		'POST',
-		`/cli/deploy/2/fail/${deploymentId}`,
-		DeploymentFailAPIResponseSchema,
-		payload,
-		DeploymentFailPayloadSchema
-	);
-	if (!resp.success) {
-		throw new ProjectResponseError({ message: resp.message });
-	}
-}