@ottocode/server 0.1.212 → 0.1.215

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@ottocode/server",
-	"version": "0.1.212",
+	"version": "0.1.215",
 	"description": "HTTP API server for ottocode",
 	"type": "module",
 	"main": "./src/index.ts",
@@ -49,14 +49,14 @@
 		"typecheck": "tsc --noEmit"
 	},
 	"dependencies": {
-		"@ottocode/sdk": "0.1.212",
-		"@ottocode/database": "0.1.212",
+		"@ottocode/sdk": "0.1.215",
+		"@ottocode/database": "0.1.215",
 		"drizzle-orm": "^0.44.5",
 		"hono": "^4.9.9",
-		"zod": "^4.1.8"
+		"zod": "^4.3.6"
 	},
 	"devDependencies": {
 		"@types/bun": "latest",
-		"typescript": "^5"
+		"typescript": "~5.9.3"
 	}
 }

package/src/index.ts

@@ -22,6 +22,8 @@ import { registerAuthRoutes } from './routes/auth.ts';
 import { registerTunnelRoutes } from './routes/tunnel.ts';
 import { registerMCPRoutes } from './routes/mcp.ts';
 import { registerProviderUsageRoutes } from './routes/provider-usage.ts';
+import { registerDoctorRoutes } from './routes/doctor.ts';
+import { registerSkillsRoutes } from './routes/skills.ts';
 import type { AgentConfigEntry } from './runtime/agent/registry.ts';
 
 const globalTerminalManager = new TerminalManager();
@@ -80,6 +82,8 @@ function initApp() {
 	registerTunnelRoutes(app);
 	registerMCPRoutes(app);
 	registerProviderUsageRoutes(app);
+	registerDoctorRoutes(app);
+	registerSkillsRoutes(app);
 
 	return app;
 }

package/src/openapi/paths/auth.ts

@@ -0,0 +1,497 @@
+import { errorResponse } from '../helpers';
+
+export const authPaths = {
+	'/v1/auth/status': {
+		get: {
+			tags: ['auth'],
+			operationId: 'getAuthStatus',
+			summary: 'Get auth status for all providers',
+			responses: {
+				200: {
+					description: 'OK',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: {
+									onboardingComplete: { type: 'boolean' },
+									setu: {
+										type: 'object',
+										properties: {
+											configured: { type: 'boolean' },
+											publicKey: { type: 'string' },
+										},
+										required: ['configured'],
+									},
+									providers: {
+										type: 'object',
+										additionalProperties: {
+											type: 'object',
+											properties: {
+												configured: { type: 'boolean' },
+												type: {
+													type: 'string',
+													enum: ['api', 'oauth', 'wallet'],
+												},
+												label: { type: 'string' },
+												supportsOAuth: { type: 'boolean' },
+												modelCount: { type: 'integer' },
+												costRange: {
+													type: 'object',
+													nullable: true,
+													properties: {
+														min: { type: 'number' },
+														max: { type: 'number' },
+													},
+													required: ['min', 'max'],
+												},
+											},
+											required: [
+												'configured',
+												'label',
+												'supportsOAuth',
+												'modelCount',
+											],
+										},
+									},
+									defaults: {
+										type: 'object',
+										properties: {
+											agent: { type: 'string' },
+											provider: { type: 'string' },
+											model: { type: 'string' },
+										},
+									},
+								},
+								required: ['onboardingComplete', 'setu', 'providers'],
+							},
+						},
+					},
+				},
+			},
+		},
+	},
+	'/v1/auth/setu/setup': {
+		post: {
+			tags: ['auth'],
+			operationId: 'setupSetuWallet',
+			summary: 'Setup or ensure Setu wallet',
+			responses: {
+				200: {
+					description: 'OK',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: {
+									success: { type: 'boolean' },
+									publicKey: { type: 'string' },
+									isNew: { type: 'boolean' },
+								},
+								required: ['success', 'publicKey', 'isNew'],
+							},
+						},
+					},
+				},
+			},
+		},
+	},
+	'/v1/auth/setu/import': {
+		post: {
+			tags: ['auth'],
+			operationId: 'importSetuWallet',
+			summary: 'Import Setu wallet from private key',
+			requestBody: {
+				required: true,
+				content: {
+					'application/json': {
+						schema: {
+							type: 'object',
+							properties: {
+								privateKey: { type: 'string' },
+							},
+							required: ['privateKey'],
+						},
+					},
+				},
+			},
+			responses: {
+				200: {
+					description: 'OK',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: {
+									success: { type: 'boolean' },
+									publicKey: { type: 'string' },
+								},
+								required: ['success', 'publicKey'],
+							},
+						},
+					},
+				},
+				400: errorResponse(),
+			},
+		},
+	},
+	'/v1/auth/setu/export': {
+		get: {
+			tags: ['auth'],
+			operationId: 'exportSetuWallet',
+			summary: 'Export Setu wallet private key',
+			responses: {
+				200: {
+					description: 'OK',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: {
+									success: { type: 'boolean' },
+									publicKey: { type: 'string' },
+									privateKey: { type: 'string' },
+								},
+								required: ['success', 'publicKey', 'privateKey'],
+							},
+						},
+					},
+				},
+				404: errorResponse(),
+			},
+		},
+	},
+	'/v1/auth/{provider}': {
+		post: {
+			tags: ['auth'],
+			operationId: 'addProviderApiKey',
+			summary: 'Add API key for a provider',
+			parameters: [
+				{
+					in: 'path',
+					name: 'provider',
+					required: true,
+					schema: { type: 'string' },
+				},
+			],
+			requestBody: {
+				required: true,
+				content: {
+					'application/json': {
+						schema: {
+							type: 'object',
+							properties: {
+								apiKey: { type: 'string' },
+							},
+							required: ['apiKey'],
+						},
+					},
+				},
+			},
+			responses: {
+				200: {
+					description: 'OK',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: {
+									success: { type: 'boolean' },
+									provider: { type: 'string' },
+								},
+								required: ['success', 'provider'],
+							},
+						},
+					},
+				},
+				400: errorResponse(),
+			},
+		},
+		delete: {
+			tags: ['auth'],
+			operationId: 'removeProvider',
+			summary: 'Remove auth for a provider',
+			parameters: [
+				{
+					in: 'path',
+					name: 'provider',
+					required: true,
+					schema: { type: 'string' },
+				},
+			],
+			responses: {
+				200: {
+					description: 'OK',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: {
+									success: { type: 'boolean' },
+									provider: { type: 'string' },
+								},
+								required: ['success', 'provider'],
+							},
+						},
+					},
+				},
+				400: errorResponse(),
+			},
+		},
+	},
+	'/v1/auth/{provider}/oauth/url': {
+		post: {
+			tags: ['auth'],
+			operationId: 'getOAuthUrl',
+			summary: 'Get OAuth authorization URL',
+			parameters: [
+				{
+					in: 'path',
+					name: 'provider',
+					required: true,
+					schema: { type: 'string' },
+				},
+			],
+			requestBody: {
+				required: false,
+				content: {
+					'application/json': {
+						schema: {
+							type: 'object',
+							properties: {
+								mode: {
+									type: 'string',
+									enum: ['max', 'console'],
+									default: 'max',
+								},
+							},
+						},
+					},
+				},
+			},
+			responses: {
+				200: {
+					description: 'OK',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: {
+									url: { type: 'string' },
+									sessionId: { type: 'string' },
+									provider: { type: 'string' },
+								},
+								required: ['url', 'sessionId', 'provider'],
+							},
+						},
+					},
+				},
+				400: errorResponse(),
+			},
+		},
+	},
+	'/v1/auth/{provider}/oauth/exchange': {
+		post: {
+			tags: ['auth'],
+			operationId: 'exchangeOAuthCode',
+			summary: 'Exchange OAuth code for tokens',
+			parameters: [
+				{
+					in: 'path',
+					name: 'provider',
+					required: true,
+					schema: { type: 'string' },
+				},
+			],
+			requestBody: {
+				required: true,
+				content: {
+					'application/json': {
+						schema: {
+							type: 'object',
+							properties: {
+								code: { type: 'string' },
+								sessionId: { type: 'string' },
+							},
+							required: ['code', 'sessionId'],
+						},
+					},
+				},
+			},
+			responses: {
+				200: {
+					description: 'OK',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: {
+									success: { type: 'boolean' },
+									provider: { type: 'string' },
+								},
+								required: ['success', 'provider'],
+							},
+						},
+					},
+				},
+				400: errorResponse(),
+			},
+		},
+	},
+	'/v1/auth/{provider}/oauth/start': {
+		get: {
+			tags: ['auth'],
+			operationId: 'startOAuth',
+			summary: 'Start OAuth flow with redirect',
+			parameters: [
+				{
+					in: 'path',
+					name: 'provider',
+					required: true,
+					schema: { type: 'string' },
+				},
+				{
+					in: 'query',
+					name: 'mode',
+					required: false,
+					schema: {
+						type: 'string',
+						enum: ['max', 'console'],
+						default: 'max',
+					},
+				},
+			],
+			responses: {
+				302: { description: 'Redirect to OAuth provider' },
+				400: errorResponse(),
+			},
+		},
+	},
+	'/v1/auth/{provider}/oauth/callback': {
+		get: {
+			tags: ['auth'],
+			operationId: 'oauthCallback',
+			summary: 'OAuth callback handler',
+			parameters: [
+				{
+					in: 'path',
+					name: 'provider',
+					required: true,
+					schema: { type: 'string' },
+				},
+				{
+					in: 'query',
+					name: 'code',
+					required: false,
+					schema: { type: 'string' },
+				},
+				{
+					in: 'query',
+					name: 'fragment',
+					required: false,
+					schema: { type: 'string' },
+				},
+			],
+			responses: {
+				200: {
+					description: 'HTML response',
+					content: { 'text/html': { schema: { type: 'string' } } },
+				},
+			},
+		},
+	},
+	'/v1/auth/copilot/device/start': {
+		post: {
+			tags: ['auth'],
+			operationId: 'startCopilotDeviceFlow',
+			summary: 'Start Copilot device flow authentication',
+			responses: {
+				200: {
+					description: 'OK',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: {
+									sessionId: { type: 'string' },
+									userCode: { type: 'string' },
+									verificationUri: { type: 'string' },
+									interval: { type: 'integer' },
+								},
+								required: [
+									'sessionId',
+									'userCode',
+									'verificationUri',
+									'interval',
+								],
+							},
+						},
+					},
+				},
+			},
+		},
+	},
+	'/v1/auth/copilot/device/poll': {
+		post: {
+			tags: ['auth'],
+			operationId: 'pollCopilotDeviceFlow',
+			summary: 'Poll Copilot device flow for completion',
+			requestBody: {
+				required: true,
+				content: {
+					'application/json': {
+						schema: {
+							type: 'object',
+							properties: {
+								sessionId: { type: 'string' },
+							},
+							required: ['sessionId'],
+						},
+					},
+				},
+			},
+			responses: {
+				200: {
+					description: 'OK',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: {
+									status: {
+										type: 'string',
+										enum: ['complete', 'pending', 'error'],
+									},
+									error: { type: 'string' },
+								},
+								required: ['status'],
+							},
+						},
+					},
+				},
+				400: errorResponse(),
+			},
+		},
+	},
+	'/v1/auth/onboarding/complete': {
+		post: {
+			tags: ['auth'],
+			operationId: 'completeOnboarding',
+			summary: 'Mark onboarding as complete',
+			responses: {
+				200: {
+					description: 'OK',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: { success: { type: 'boolean' } },
+								required: ['success'],
+							},
+						},
+					},
+				},
+			},
+		},
+	},
+} as const;

package/src/openapi/paths/branch.ts

@@ -0,0 +1,102 @@
+import { errorResponse, projectQueryParam } from '../helpers';
+
+const sessionIdParam = {
+	in: 'path',
+	name: 'sessionId',
+	required: true,
+	schema: { type: 'string' },
+} as const;
+
+export const branchPaths = {
+	'/v1/sessions/{sessionId}/branch': {
+		post: {
+			tags: ['sessions'],
+			operationId: 'createBranch',
+			summary: 'Create a branch from a session message',
+			parameters: [sessionIdParam, projectQueryParam()],
+			requestBody: {
+				required: true,
+				content: {
+					'application/json': {
+						schema: {
+							type: 'object',
+							properties: {
+								fromMessageId: { type: 'string' },
+								provider: { type: 'string' },
+								model: { type: 'string' },
+								agent: { type: 'string' },
+								title: { type: 'string' },
+							},
+							required: ['fromMessageId'],
+						},
+					},
+				},
+			},
+			responses: {
+				201: {
+					description: 'Created',
+					content: {
+						'application/json': {
+							schema: { $ref: '#/components/schemas/Session' },
+						},
+					},
+				},
+				400: errorResponse(),
+			},
+		},
+	},
+	'/v1/sessions/{sessionId}/branches': {
+		get: {
+			tags: ['sessions'],
+			operationId: 'listBranches',
+			summary: 'List branches of a session',
+			parameters: [sessionIdParam, projectQueryParam()],
+			responses: {
+				200: {
+					description: 'OK',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: {
+									branches: {
+										type: 'array',
+										items: { $ref: '#/components/schemas/Session' },
+									},
+								},
+								required: ['branches'],
+							},
+						},
+					},
+				},
+			},
+		},
+	},
+	'/v1/sessions/{sessionId}/parent': {
+		get: {
+			tags: ['sessions'],
+			operationId: 'getParentSession',
+			summary: 'Get parent session of a branch',
+			parameters: [sessionIdParam, projectQueryParam()],
+			responses: {
+				200: {
+					description: 'OK',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: {
+									parent: {
+										nullable: true,
+										allOf: [{ $ref: '#/components/schemas/Session' }],
+									},
+								},
+								required: ['parent'],
+							},
+						},
+					},
+				},
+			},
+		},
+	},
+} as const;

package/src/openapi/paths/config.ts

@@ -215,4 +215,47 @@ export const configPaths = {
 			},
 		},
 	},
+	'/v1/config/models': {
+		get: {
+			tags: ['config'],
+			operationId: 'getAllModels',
+			summary: 'Get all models across authorized providers',
+			parameters: [projectQueryParam()],
+			responses: {
+				200: {
+					description: 'OK',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								additionalProperties: {
+									type: 'object',
+									properties: {
+										label: { type: 'string' },
+										authType: { type: 'string' },
+										models: {
+											type: 'array',
+											items: {
+												type: 'object',
+												properties: {
+													id: { type: 'string' },
+													label: { type: 'string' },
+													toolCall: { type: 'boolean' },
+													reasoningText: { type: 'boolean' },
+													vision: { type: 'boolean' },
+													attachment: { type: 'boolean' },
+												},
+												required: ['id', 'label'],
+											},
+										},
+									},
+									required: ['label', 'models'],
+								},
+							},
+						},
+					},
+				},
+			},
+		},
+	},
 } as const;