@agentuity/core 2.0.11 → 3.0.0-alpha.0

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@agentuity/core",
-	"version": "2.0.11",
+	"version": "3.0.0-alpha.0",
 	"license": "Apache-2.0",
 	"author": "Agentuity employees and contributors",
 	"type": "module",
@@ -46,6 +46,106 @@
 			"types": "./dist/services/api.d.ts",
 			"default": "./dist/services/api.js"
 		},
+		"./apikey": {
+			"types": "./dist/services/apikey/index.d.ts",
+			"default": "./dist/services/apikey/index.js"
+		},
+		"./auth": {
+			"types": "./dist/services/auth/index.d.ts",
+			"default": "./dist/services/auth/index.js"
+		},
+		"./coder": {
+			"types": "./dist/services/coder/index.d.ts",
+			"default": "./dist/services/coder/index.js"
+		},
+		"./db": {
+			"types": "./dist/services/db/index.d.ts",
+			"default": "./dist/services/db/index.js"
+		},
+		"./email": {
+			"types": "./dist/services/email/index.d.ts",
+			"default": "./dist/services/email/index.js"
+		},
+		"./eval": {
+			"types": "./dist/services/eval/index.d.ts",
+			"default": "./dist/services/eval/index.js"
+		},
+		"./keyvalue": {
+			"types": "./dist/services/keyvalue/index.d.ts",
+			"default": "./dist/services/keyvalue/index.js"
+		},
+		"./machine": {
+			"types": "./dist/services/machine/index.d.ts",
+			"default": "./dist/services/machine/index.js"
+		},
+		"./monitoring": {
+			"types": "./dist/services/monitoring/index.d.ts",
+			"default": "./dist/services/monitoring/index.js"
+		},
+		"./oauth": {
+			"types": "./dist/services/oauth/index.d.ts",
+			"default": "./dist/services/oauth/index.js"
+		},
+		"./org": {
+			"types": "./dist/services/org/index.d.ts",
+			"default": "./dist/services/org/index.js"
+		},
+		"./project": {
+			"types": "./dist/services/project/index.d.ts",
+			"default": "./dist/services/project/index.js"
+		},
+		"./queue": {
+			"types": "./dist/services/queue/index.d.ts",
+			"default": "./dist/services/queue/index.js"
+		},
+		"./region": {
+			"types": "./dist/services/region/index.d.ts",
+			"default": "./dist/services/region/index.js"
+		},
+		"./sandbox": {
+			"types": "./dist/services/sandbox/index.d.ts",
+			"default": "./dist/services/sandbox/index.js"
+		},
+		"./schedule": {
+			"types": "./dist/services/schedule/index.d.ts",
+			"default": "./dist/services/schedule/index.js"
+		},
+		"./session": {
+			"types": "./dist/services/session/index.d.ts",
+			"default": "./dist/services/session/index.js"
+		},
+		"./storage": {
+			"types": "./dist/services/storage/index.d.ts",
+			"default": "./dist/services/storage/index.js"
+		},
+		"./stream": {
+			"types": "./dist/services/stream/index.d.ts",
+			"default": "./dist/services/stream/index.js"
+		},
+		"./task": {
+			"types": "./dist/services/task/index.d.ts",
+			"default": "./dist/services/task/index.js"
+		},
+		"./thread": {
+			"types": "./dist/services/thread/index.d.ts",
+			"default": "./dist/services/thread/index.js"
+		},
+		"./user": {
+			"types": "./dist/services/user/index.d.ts",
+			"default": "./dist/services/user/index.js"
+		},
+		"./vector": {
+			"types": "./dist/services/vector/index.d.ts",
+			"default": "./dist/services/vector/index.js"
+		},
+		"./webhook": {
+			"types": "./dist/services/webhook/index.d.ts",
+			"default": "./dist/services/webhook/index.js"
+		},
+		"./workflow": {
+			"types": "./dist/services/workflow/index.d.ts",
+			"default": "./dist/services/workflow/index.js"
+		},
 		"./*": {
 			"types": "./dist/services/*/index.d.ts",
 			"default": "./dist/services/*/index.js"
@@ -74,6 +174,81 @@
 			"api": [
 				"./dist/services/api.d.ts"
 			],
+			"apikey": [
+				"./dist/services/apikey/index.d.ts"
+			],
+			"auth": [
+				"./dist/services/auth/index.d.ts"
+			],
+			"coder": [
+				"./dist/services/coder/index.d.ts"
+			],
+			"db": [
+				"./dist/services/db/index.d.ts"
+			],
+			"email": [
+				"./dist/services/email/index.d.ts"
+			],
+			"eval": [
+				"./dist/services/eval/index.d.ts"
+			],
+			"keyvalue": [
+				"./dist/services/keyvalue/index.d.ts"
+			],
+			"machine": [
+				"./dist/services/machine/index.d.ts"
+			],
+			"monitoring": [
+				"./dist/services/monitoring/index.d.ts"
+			],
+			"oauth": [
+				"./dist/services/oauth/index.d.ts"
+			],
+			"org": [
+				"./dist/services/org/index.d.ts"
+			],
+			"project": [
+				"./dist/services/project/index.d.ts"
+			],
+			"queue": [
+				"./dist/services/queue/index.d.ts"
+			],
+			"region": [
+				"./dist/services/region/index.d.ts"
+			],
+			"sandbox": [
+				"./dist/services/sandbox/index.d.ts"
+			],
+			"schedule": [
+				"./dist/services/schedule/index.d.ts"
+			],
+			"session": [
+				"./dist/services/session/index.d.ts"
+			],
+			"storage": [
+				"./dist/services/storage/index.d.ts"
+			],
+			"stream": [
+				"./dist/services/stream/index.d.ts"
+			],
+			"task": [
+				"./dist/services/task/index.d.ts"
+			],
+			"thread": [
+				"./dist/services/thread/index.d.ts"
+			],
+			"user": [
+				"./dist/services/user/index.d.ts"
+			],
+			"vector": [
+				"./dist/services/vector/index.d.ts"
+			],
+			"webhook": [
+				"./dist/services/webhook/index.d.ts"
+			],
+			"workflow": [
+				"./dist/services/workflow/index.d.ts"
+			],
 			"*": [
 				"./dist/services/*/index.d.ts"
 			]
@@ -89,7 +264,7 @@
 		"zod": "^4.3.5"
 	},
 	"devDependencies": {
-		"@agentuity/test-utils": "2.0.11",
+		"@agentuity/test-utils": "3.0.0-alpha.0",
 		"@types/bun": "latest",
 		"bun-types": "latest",
 		"esbuild": "^0.25.0",
@@ -98,5 +273,10 @@
 	"publishConfig": {
 		"access": "public"
 	},
-	"sideEffects": false
+	"sideEffects": false,
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/agentuity/sdk.git",
+		"directory": "packages/core"
+	}
 }

package/src/services/coder/api-reference.ts

@@ -451,8 +451,8 @@ const service: Service = {
 				slug: 'code-review',
 				displayName: 'Code Review',
 				instructions: 'Focus on correctness, regressions, and missing tests.',
-				piTools: ['read', 'grep', 'ls'],
-				hubToolNames: ['session_todo_list', 'session_todo_update'],
+				tools: ['read', 'grep', 'ls'],
+				serviceTools: ['session_todo_list', 'session_todo_update'],
 			},
 		},
 		{

package/src/services/coder/types.ts

@@ -115,11 +115,11 @@ export const CoderWorkspaceDetailSchema = z
 		repoCount: z.number().describe('Number of repositories'),
 		savedSkillIds: z.array(z.string()).describe('Saved skill IDs in workspace'),
 		skillBucketIds: z.array(z.string()).describe('Skill bucket IDs in workspace'),
-		agentSlugs: z
+		enabledAgents: z
 			.array(z.string())
 			.optional()
 			.default([])
-			.describe('Published custom agent slugs in workspace'),
+			.describe('Effective agent roster stored on the workspace'),
 		selectionCount: z.number().describe('Total number of selections'),
 		createdAt: z.string().describe('Creation timestamp (ISO-8601)'),
 		updatedAt: z.string().describe('Last update timestamp (ISO-8601)'),
@@ -133,7 +133,7 @@ export const CoderCustomAgentThinkingLevelSchema = z
 	.describe('Thinking level override for a custom agent');
 export type CoderCustomAgentThinkingLevel = z.infer<typeof CoderCustomAgentThinkingLevelSchema>;
 
-export const CODER_CUSTOM_AGENT_PI_TOOLS = [
+export const CODER_CUSTOM_AGENT_TOOLS = [
 	'read',
 	'ls',
 	'find',
@@ -143,17 +143,17 @@ export const CODER_CUSTOM_AGENT_PI_TOOLS = [
 	'edit',
 ] as const;
 
-export const CoderCustomAgentPiToolSchema = z
-	.enum(CODER_CUSTOM_AGENT_PI_TOOLS)
+export const CoderCustomAgentToolSchema = z
+	.enum(CODER_CUSTOM_AGENT_TOOLS)
 	.describe('Workspace tool available to a standalone custom agent');
-export type CoderCustomAgentPiTool = z.infer<typeof CoderCustomAgentPiToolSchema>;
+export type CoderCustomAgentTool = z.infer<typeof CoderCustomAgentToolSchema>;
 
-export const CoderCustomAgentPiToolResponseSchema = z
-	.union([CoderCustomAgentPiToolSchema, z.string()])
-	.describe('Pi workspace tool granted to a standalone custom agent');
-export type CoderCustomAgentPiToolResponse = z.infer<typeof CoderCustomAgentPiToolResponseSchema>;
+export const CoderCustomAgentToolResponseSchema = z
+	.union([CoderCustomAgentToolSchema, z.string()])
+	.describe('Workspace tool granted to a standalone custom agent');
+export type CoderCustomAgentToolResponse = z.infer<typeof CoderCustomAgentToolResponseSchema>;
 
-export const CODER_CUSTOM_AGENT_HUB_TOOLS = [
+export const CODER_CUSTOM_AGENT_SERVICE_TOOLS = [
 	'session_dashboard',
 	'memory_service_search',
 	'memory_service_store',
@@ -198,15 +198,17 @@ export const CODER_CUSTOM_AGENT_HUB_TOOLS = [
 	'coord_spawn_workers',
 ] as const;
 
-export const CoderCustomAgentHubToolSchema = z
-	.enum(CODER_CUSTOM_AGENT_HUB_TOOLS)
-	.describe('Hub-managed tool available to a standalone custom agent');
-export type CoderCustomAgentHubTool = z.infer<typeof CoderCustomAgentHubToolSchema>;
+export const CoderCustomAgentServiceToolSchema = z
+	.enum(CODER_CUSTOM_AGENT_SERVICE_TOOLS)
+	.describe('Service tool available to a standalone custom agent');
+export type CoderCustomAgentServiceTool = z.infer<typeof CoderCustomAgentServiceToolSchema>;
 
-export const CoderCustomAgentHubToolResponseSchema = z
-	.union([CoderCustomAgentHubToolSchema, z.string()])
-	.describe('Hub-managed tool granted to a standalone custom agent');
-export type CoderCustomAgentHubToolResponse = z.infer<typeof CoderCustomAgentHubToolResponseSchema>;
+export const CoderCustomAgentServiceToolResponseSchema = z
+	.union([CoderCustomAgentServiceToolSchema, z.string()])
+	.describe('Service tool granted to a standalone custom agent');
+export type CoderCustomAgentServiceToolResponse = z.infer<
+	typeof CoderCustomAgentServiceToolResponseSchema
+>;
 
 export const CoderCustomAgentSnapshotSchema = z
 	.object({
@@ -221,15 +223,19 @@ export const CoderCustomAgentSnapshotSchema = z
 		headlessCompatible: z
 			.boolean()
 			.describe('Whether the custom agent is safe for non-interactive callers'),
-		piTools: z
-			.array(CoderCustomAgentPiToolResponseSchema)
-			.describe('Pi workspace tools granted to the custom agent'),
-		hubToolNames: z
-			.array(CoderCustomAgentHubToolResponseSchema)
-			.describe('Hub-managed tools granted to the custom agent'),
+		tools: z
+			.array(CoderCustomAgentToolResponseSchema)
+			.describe('Workspace tools granted to the custom agent'),
+		serviceTools: z
+			.array(CoderCustomAgentServiceToolResponseSchema)
+			.describe('Service tools granted to the custom agent'),
 		savedSkills: z
 			.array(CoderSkillRefSchema)
 			.describe('Frozen saved-skill refs attached to the custom agent snapshot'),
+		companionAgents: z
+			.array(z.string())
+			.default([])
+			.describe('Companion agents auto-included alongside this custom agent'),
 	})
 	.passthrough()
 	.describe('Custom agent snapshot returned by coder hub');
@@ -324,7 +330,10 @@ export const CoderCreateWorkspaceRequestSchema = z
 		repos: z.array(CoderSessionRepositoryRefSchema).optional().describe('Repositories'),
 		savedSkillIds: z.array(z.string()).optional().describe('Saved skill IDs'),
 		skillBucketIds: z.array(z.string()).optional().describe('Skill bucket IDs'),
-		agentSlugs: z.array(z.string()).optional().describe('Published custom agent slugs'),
+		enabledAgents: z
+			.array(z.string())
+			.optional()
+			.describe('Effective agent roster to store on the workspace'),
 	})
 	.describe('Request body for creating a workspace');
 export type CoderCreateWorkspaceRequest = z.infer<typeof CoderCreateWorkspaceRequestSchema>;
@@ -343,18 +352,22 @@ export const CoderCreateCustomAgentRequestSchema = z
 			.boolean()
 			.optional()
 			.describe('Whether the custom agent is safe for non-interactive callers'),
-		piTools: z
-			.array(CoderCustomAgentPiToolSchema)
+		tools: z
+			.array(CoderCustomAgentToolSchema)
 			.optional()
-			.describe('Pi workspace tools to grant to the custom agent'),
-		hubToolNames: z
-			.array(CoderCustomAgentHubToolSchema)
+			.describe('Workspace tools to grant to the custom agent'),
+		serviceTools: z
+			.array(CoderCustomAgentServiceToolSchema)
 			.optional()
-			.describe('Hub-managed tools to grant to the custom agent'),
+			.describe('Service tools to grant to the custom agent'),
 		savedSkillIds: z
 			.array(z.string())
 			.optional()
 			.describe('Saved skill row ids to snapshot onto the custom agent'),
+		companionAgents: z
+			.array(z.string())
+			.optional()
+			.describe('Agent names to auto-include alongside this custom agent'),
 	})
 	.describe('Request body for creating a custom agent draft');
 export type CoderCreateCustomAgentRequest = z.infer<typeof CoderCreateCustomAgentRequestSchema>;
@@ -373,18 +386,22 @@ export const CoderUpdateCustomAgentRequestSchema = z
 			.boolean()
 			.optional()
 			.describe('Whether the custom agent is safe for non-interactive callers'),
-		piTools: z
-			.array(CoderCustomAgentPiToolSchema)
+		tools: z
+			.array(CoderCustomAgentToolSchema)
 			.optional()
-			.describe('Pi workspace tools to grant to the custom agent'),
-		hubToolNames: z
-			.array(CoderCustomAgentHubToolSchema)
+			.describe('Workspace tools to grant to the custom agent'),
+		serviceTools: z
+			.array(CoderCustomAgentServiceToolSchema)
 			.optional()
-			.describe('Hub-managed tools to grant to the custom agent'),
+			.describe('Service tools to grant to the custom agent'),
 		savedSkillIds: z
 			.array(z.string())
 			.optional()
 			.describe('Saved skill row ids to snapshot onto the custom agent'),
+		companionAgents: z
+			.array(z.string())
+			.optional()
+			.describe('Agent names to auto-include alongside this custom agent'),
 	})
 	.describe('Request body for updating a custom agent draft');
 export type CoderUpdateCustomAgentRequest = z.infer<typeof CoderUpdateCustomAgentRequestSchema>;
@@ -447,10 +464,10 @@ export const CoderCreateSessionRequestSchema = z
 		workflowMode: CoderWorkflowModeSchema.optional().describe('Workflow execution mode'),
 		loop: CoderSessionLoopConfigSchema.optional().describe('Loop mode settings for the session'),
 		tags: z.array(z.string()).optional().describe('Tags applied to the session for filtering'),
-		agentSlugs: z
+		enabledAgents: z
 			.array(z.string())
 			.optional()
-			.describe('Published custom agent slugs to include in the session'),
+			.describe('Enabled agent roster to include in the session'),
 		savedSkillIds: z
 			.array(z.string())
 			.optional()
@@ -495,10 +512,10 @@ export const CoderUpdateSessionRequestSchema = z
 		workflowMode: CoderWorkflowModeSchema.optional().describe('Updated workflow mode'),
 		loop: CoderSessionLoopConfigSchema.optional().describe('Updated loop mode configuration'),
 		tags: z.array(z.string()).optional().describe('Updated set of tags for the session'),
-		agentSlugs: z
+		enabledAgents: z
 			.array(z.string())
 			.optional()
-			.describe('Updated published custom agent slugs included in the session'),
+			.describe('Updated enabled agent roster for the session'),
 		skills: z
 			.array(CoderSkillRefSchema)
 			.optional()
@@ -580,11 +597,11 @@ export const CoderSessionListItemSchema = z
 		participantCount: z.number().describe('Total number of participants in the session'),
 		tags: z.array(z.string()).describe('Tag values attached to the session'),
 		skills: z.array(CoderSkillRefSchema).describe('Skills attached to the session'),
-		agentSlugs: z
+		enabledAgents: z
 			.array(z.string())
 			.optional()
 			.default([])
-			.describe('Published custom agent slugs attached to the session'),
+			.describe('Enabled agent roster attached to the session'),
 		defaultAgent: z.string().optional().describe('Default agent assigned to session operations'),
 		bucket: CoderSessionBucketSchema.describe('Derived bucket for session listing'),
 		runtimeAvailable: z.boolean().describe('Whether runtime is currently reachable'),

package/src/services/project/deploy.ts

@@ -73,33 +73,71 @@ export const BuildAgentSchema = z.object({
 	...BaseAgentFields,
 });
 
+/**
+ * Launch process definition — describes how to start the application.
+ * Produced by the buildpack pipeline for any framework.
+ */
+export const LaunchProcessSchema = z.object({
+	type: z.string().describe('process type (e.g., web, worker)'),
+	command: z.string().describe('command to execute'),
+	default: z.boolean().describe('whether this is the default process'),
+	workingDirectory: z.string().optional().describe('working directory relative to app root'),
+});
+
+export const LaunchMetadataSchema = z.object({
+	processes: z.array(LaunchProcessSchema).describe('application processes'),
+	framework: z.object({
+		name: z.string().describe('detected framework name'),
+		version: z.string().optional().describe('framework version'),
+	}),
+	runtime: z.object({
+		name: z.string().describe('runtime binary (node, bun, deno)'),
+		port: z.number().optional().describe('port the app listens on'),
+	}),
+	build: z.object({
+		date: z.string().describe('build timestamp'),
+		duration: z.number().describe('build duration in ms'),
+	}),
+});
+
+export type LaunchMetadata = z.infer<typeof LaunchMetadataSchema>;
+
 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),
+	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'),
+			})
+		)
+		.default([])
+		.describe('routes — only present for Agentuity native apps'),
+	agents: z
+		.array(BuildAgentSchema)
+		.default([])
+		.describe('agents — only present for Agentuity native apps'),
 	assets: z.array(
 		z.object({
 			filename: z.string().describe('the relative path for the file'),
@@ -176,6 +214,9 @@ export const BuildMetadataSchema = z.object({
 			}),
 		})
 	),
+	launch: LaunchMetadataSchema.optional().describe(
+		'launch metadata — how to start the application (processes, framework, runtime)'
+	),
 });
 
 export type BuildMetadata = z.infer<typeof BuildMetadataSchema>;