Add adapter environment testing infrastructure

Introduce testEnvironment() on ServerAdapterModule with structured
pass/warn/fail diagnostics for all four adapter types (claude_local,
codex_local, process, http). Adds POST test-environment endpoint,
shared types/validators, adapter test implementations, and UI API
client. Includes asset type foundations used by related features.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

packages/shared/src/index.ts

@@ -43,6 +43,11 @@ export type {
   AgentPermissions,
   AgentKeyCreated,
   AgentConfigRevision,
+  AdapterEnvironmentCheckLevel,
+  AdapterEnvironmentTestStatus,
+  AdapterEnvironmentCheck,
+  AdapterEnvironmentTestResult,
+  AssetImage,
   Project,
   Issue,
   IssueComment,
@@ -79,6 +84,7 @@ export {
   createAgentKeySchema,
   wakeAgentSchema,
   resetAgentSessionSchema,
+  testAdapterEnvironmentSchema,
   agentPermissionsSchema,
   updateAgentPermissionsSchema,
   type CreateAgent,
@@ -87,6 +93,7 @@ export {
   type CreateAgentKey,
   type WakeAgent,
   type ResetAgentSession,
+  type TestAdapterEnvironment,
   type UpdateAgentPermissions,
   createProjectSchema,
   updateProjectSchema,
@@ -130,8 +137,10 @@ export {
   type UpdateSecret,
   createCostEventSchema,
   updateBudgetSchema,
+  createAssetImageMetadataSchema,
   type CreateCostEvent,
   type UpdateBudget,
+  type CreateAssetImageMetadata,
 } from "./validators/index.js";
 
 export { API_PREFIX, API } from "./api.js";

packages/shared/src/types/agent.ts

@@ -49,3 +49,21 @@ export interface AgentConfigRevision {
   afterConfig: Record<string, unknown>;
   createdAt: Date;
 }
+
+export type AdapterEnvironmentCheckLevel = "info" | "warn" | "error";
+export type AdapterEnvironmentTestStatus = "pass" | "warn" | "fail";
+
+export interface AdapterEnvironmentCheck {
+  code: string;
+  level: AdapterEnvironmentCheckLevel;
+  message: string;
+  detail?: string | null;
+  hint?: string | null;
+}
+
+export interface AdapterEnvironmentTestResult {
+  adapterType: string;
+  status: AdapterEnvironmentTestStatus;
+  checks: AdapterEnvironmentCheck[];
+  testedAt: string;
+}

packages/shared/src/types/asset.ts

@@ -0,0 +1,16 @@
+export interface AssetImage {
+  assetId: string;
+  companyId: string;
+  provider: string;
+  objectKey: string;
+  contentType: string;
+  byteSize: number;
+  sha256: string;
+  originalFilename: string | null;
+  createdByAgentId: string | null;
+  createdByUserId: string | null;
+  createdAt: Date;
+  updatedAt: Date;
+  contentPath: string;
+}
+

packages/shared/src/types/index.ts

@@ -1,5 +1,15 @@
 export type { Company } from "./company.js";
-export type { Agent, AgentPermissions, AgentKeyCreated, AgentConfigRevision } from "./agent.js";
+export type {
+  Agent,
+  AgentPermissions,
+  AgentKeyCreated,
+  AgentConfigRevision,
+  AdapterEnvironmentCheckLevel,
+  AdapterEnvironmentTestStatus,
+  AdapterEnvironmentCheck,
+  AdapterEnvironmentTestResult,
+} from "./agent.js";
+export type { AssetImage } from "./asset.js";
 export type { Project } from "./project.js";
 export type {
   Issue,

packages/shared/src/validators/agent.ts

@@ -79,6 +79,12 @@ export const resetAgentSessionSchema = z.object({
 
 export type ResetAgentSession = z.infer<typeof resetAgentSessionSchema>;
 
+export const testAdapterEnvironmentSchema = z.object({
+  adapterConfig: adapterConfigSchema.optional().default({}),
+});
+
+export type TestAdapterEnvironment = z.infer<typeof testAdapterEnvironmentSchema>;
+
 export const updateAgentPermissionsSchema = z.object({
   canCreateAgents: z.boolean(),
 });

packages/shared/src/validators/asset.ts

@@ -0,0 +1,14 @@
+import { z } from "zod";
+
+export const createAssetImageMetadataSchema = z.object({
+  namespace: z
+    .string()
+    .trim()
+    .min(1)
+    .max(120)
+    .regex(/^[a-zA-Z0-9/_-]+$/)
+    .optional(),
+});
+
+export type CreateAssetImageMetadata = z.infer<typeof createAssetImageMetadataSchema>;
+

packages/shared/src/validators/index.ts

@@ -12,6 +12,7 @@ export {
   createAgentKeySchema,
   wakeAgentSchema,
   resetAgentSessionSchema,
+  testAdapterEnvironmentSchema,
   agentPermissionsSchema,
   updateAgentPermissionsSchema,
   type CreateAgent,
@@ -20,6 +21,7 @@ export {
   type CreateAgentKey,
   type WakeAgent,
   type ResetAgentSession,
+  type TestAdapterEnvironment,
   type UpdateAgentPermissions,
 } from "./agent.js";
 
@@ -84,3 +86,8 @@ export {
   type CreateCostEvent,
   type UpdateBudget,
 } from "./cost.js";
+
+export {
+  createAssetImageMetadataSchema,
+  type CreateAssetImageMetadata,
+} from "./asset.js";