@ottocode/server 0.1.173

package/src/openapi/paths/git.ts

@@ -0,0 +1,457 @@
+import { gitErrorResponse, projectQueryParam } from '../helpers';
+
+export const gitPaths = {
+	'/v1/git/status': {
+		get: {
+			tags: ['git'],
+			operationId: 'getGitStatus',
+			summary: 'Get git status',
+			description:
+				'Returns current git status including staged, unstaged, and untracked files',
+			parameters: [projectQueryParam()],
+			responses: {
+				200: {
+					description: 'OK',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: {
+									status: { type: 'string', enum: ['ok'] },
+									data: { $ref: '#/components/schemas/GitStatus' },
+								},
+								required: ['status', 'data'],
+							},
+						},
+					},
+				},
+				400: gitErrorResponse(),
+				500: gitErrorResponse(),
+			},
+		},
+	},
+	'/v1/git/diff': {
+		get: {
+			tags: ['git'],
+			operationId: 'getGitDiff',
+			summary: 'Get git diff for a file',
+			parameters: [
+				projectQueryParam(),
+				{
+					in: 'query',
+					name: 'file',
+					required: true,
+					schema: { type: 'string' },
+					description: 'File path to get diff for',
+				},
+				{
+					in: 'query',
+					name: 'staged',
+					required: false,
+					schema: { type: 'string', enum: ['true', 'false'] },
+					description: 'Show staged diff (default: unstaged)',
+				},
+			],
+			responses: {
+				200: {
+					description: 'OK',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: {
+									status: { type: 'string', enum: ['ok'] },
+									data: { $ref: '#/components/schemas/GitDiff' },
+								},
+								required: ['status', 'data'],
+							},
+						},
+					},
+				},
+				400: gitErrorResponse(),
+				500: gitErrorResponse(),
+			},
+		},
+	},
+	'/v1/git/branch': {
+		get: {
+			tags: ['git'],
+			operationId: 'getGitBranch',
+			summary: 'Get git branch information',
+			parameters: [projectQueryParam()],
+			responses: {
+				200: {
+					description: 'OK',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: {
+									status: { type: 'string', enum: ['ok'] },
+									data: { $ref: '#/components/schemas/GitBranch' },
+								},
+								required: ['status', 'data'],
+							},
+						},
+					},
+				},
+				400: gitErrorResponse(),
+				500: gitErrorResponse(),
+			},
+		},
+	},
+	'/v1/git/stage': {
+		post: {
+			tags: ['git'],
+			operationId: 'stageFiles',
+			summary: 'Stage files',
+			requestBody: {
+				required: true,
+				content: {
+					'application/json': {
+						schema: {
+							type: 'object',
+							properties: {
+								project: { type: 'string' },
+								files: {
+									type: 'array',
+									items: { type: 'string' },
+								},
+							},
+							required: ['files'],
+						},
+					},
+				},
+			},
+			responses: {
+				200: {
+					description: 'OK',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: {
+									status: { type: 'string', enum: ['ok'] },
+									data: {
+										type: 'object',
+										properties: {
+											staged: {
+												type: 'array',
+												items: { type: 'string' },
+											},
+											failed: {
+												type: 'array',
+												items: { type: 'string' },
+											},
+										},
+										required: ['staged', 'failed'],
+									},
+								},
+								required: ['status', 'data'],
+							},
+						},
+					},
+				},
+				500: gitErrorResponse(),
+			},
+		},
+	},
+	'/v1/git/unstage': {
+		post: {
+			tags: ['git'],
+			operationId: 'unstageFiles',
+			summary: 'Unstage files',
+			requestBody: {
+				required: true,
+				content: {
+					'application/json': {
+						schema: {
+							type: 'object',
+							properties: {
+								project: { type: 'string' },
+								files: {
+									type: 'array',
+									items: { type: 'string' },
+								},
+							},
+							required: ['files'],
+						},
+					},
+				},
+			},
+			responses: {
+				200: {
+					description: 'OK',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: {
+									status: { type: 'string', enum: ['ok'] },
+									data: {
+										type: 'object',
+										properties: {
+											unstaged: {
+												type: 'array',
+												items: { type: 'string' },
+											},
+											failed: {
+												type: 'array',
+												items: { type: 'string' },
+											},
+										},
+										required: ['unstaged', 'failed'],
+									},
+								},
+								required: ['status', 'data'],
+							},
+						},
+					},
+				},
+				500: gitErrorResponse(),
+			},
+		},
+	},
+	'/v1/git/commit': {
+		post: {
+			tags: ['git'],
+			operationId: 'commitChanges',
+			summary: 'Commit staged changes',
+			requestBody: {
+				required: true,
+				content: {
+					'application/json': {
+						schema: {
+							type: 'object',
+							properties: {
+								project: { type: 'string' },
+								message: { type: 'string', minLength: 1 },
+							},
+							required: ['message'],
+						},
+					},
+				},
+			},
+			responses: {
+				200: {
+					description: 'OK',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: {
+									status: { type: 'string', enum: ['ok'] },
+									data: { $ref: '#/components/schemas/GitCommit' },
+								},
+								required: ['status', 'data'],
+							},
+						},
+					},
+				},
+				400: gitErrorResponse(),
+				500: gitErrorResponse(),
+			},
+		},
+	},
+	'/v1/git/generate-commit-message': {
+		post: {
+			tags: ['git'],
+			operationId: 'generateCommitMessage',
+			summary: 'Generate AI-powered commit message',
+			description:
+				'Uses AI to generate a commit message based on staged changes',
+			requestBody: {
+				required: false,
+				content: {
+					'application/json': {
+						schema: {
+							type: 'object',
+							properties: {
+								project: { type: 'string' },
+								sessionId: {
+									type: 'string',
+									description: 'Session ID to use session provider',
+								},
+							},
+						},
+					},
+				},
+			},
+			responses: {
+				200: {
+					description: 'OK',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: {
+									status: { type: 'string', enum: ['ok'] },
+									data: {
+										type: 'object',
+										properties: {
+											message: { type: 'string' },
+										},
+										required: ['message'],
+									},
+								},
+								required: ['status', 'data'],
+							},
+						},
+					},
+				},
+				400: gitErrorResponse(),
+				500: gitErrorResponse(),
+			},
+		},
+	},
+	'/v1/git/push': {
+		post: {
+			tags: ['git'],
+			operationId: 'pushCommits',
+			summary: 'Push commits to remote',
+			description: 'Pushes local commits to the configured remote repository',
+			requestBody: {
+				required: false,
+				content: {
+					'application/json': {
+						schema: {
+							type: 'object',
+							properties: {
+								project: { type: 'string' },
+							},
+						},
+					},
+				},
+			},
+			responses: {
+				200: {
+					description: 'OK',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: {
+									status: { type: 'string', enum: ['ok'] },
+									data: {
+										type: 'object',
+										properties: {
+											output: { type: 'string' },
+										},
+										required: ['output'],
+									},
+								},
+								required: ['status', 'data'],
+							},
+						},
+					},
+				},
+				400: gitErrorResponse(),
+				500: gitErrorResponse(),
+			},
+		},
+	},
+	'/v1/git/restore': {
+		post: {
+			tags: ['git'],
+			operationId: 'restoreFiles',
+			summary: 'Restore files to HEAD',
+			requestBody: {
+				required: true,
+				content: {
+					'application/json': {
+						schema: {
+							type: 'object',
+							properties: {
+								project: { type: 'string' },
+								files: {
+									type: 'array',
+									items: { type: 'string' },
+								},
+							},
+							required: ['files'],
+						},
+					},
+				},
+			},
+			responses: {
+				200: {
+					description: 'OK',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: {
+									status: { type: 'string', enum: ['ok'] },
+									data: {
+										type: 'object',
+										properties: {
+											restored: {
+												type: 'array',
+												items: { type: 'string' },
+											},
+										},
+										required: ['restored'],
+									},
+								},
+								required: ['status', 'data'],
+							},
+						},
+					},
+				},
+				500: gitErrorResponse(),
+			},
+		},
+	},
+	'/v1/git/delete': {
+		post: {
+			tags: ['git'],
+			operationId: 'deleteFiles',
+			summary: 'Delete untracked files',
+			requestBody: {
+				required: true,
+				content: {
+					'application/json': {
+						schema: {
+							type: 'object',
+							properties: {
+								project: { type: 'string' },
+								files: {
+									type: 'array',
+									items: { type: 'string' },
+								},
+							},
+							required: ['files'],
+						},
+					},
+				},
+			},
+			responses: {
+				200: {
+					description: 'OK',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: {
+									status: { type: 'string', enum: ['ok'] },
+									data: {
+										type: 'object',
+										properties: {
+											deleted: {
+												type: 'array',
+												items: { type: 'string' },
+											},
+										},
+										required: ['deleted'],
+									},
+								},
+								required: ['status', 'data'],
+							},
+						},
+					},
+				},
+				500: gitErrorResponse(),
+			},
+		},
+	},
+} as const;

package/src/openapi/paths/messages.ts

@@ -0,0 +1,92 @@
+import {
+	errorResponse,
+	projectQueryParam,
+	sessionIdParam,
+	withoutParam,
+} from '../helpers';
+
+export const messagesPaths = {
+	'/v1/sessions/{id}/messages': {
+		get: {
+			tags: ['messages'],
+			operationId: 'listMessages',
+			summary: 'List messages for a session',
+			parameters: [projectQueryParam(), sessionIdParam(), withoutParam()],
+			responses: {
+				200: {
+					description: 'OK',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'array',
+								items: {
+									allOf: [
+										{ $ref: '#/components/schemas/Message' },
+										{
+											type: 'object',
+											properties: {
+												parts: {
+													type: 'array',
+													items: {
+														$ref: '#/components/schemas/MessagePart',
+													},
+												},
+											},
+											required: [],
+										},
+									],
+								},
+							},
+						},
+					},
+				},
+			},
+		},
+		post: {
+			tags: ['messages'],
+			operationId: 'createMessage',
+			summary: 'Send a user message and enqueue assistant run',
+			parameters: [projectQueryParam(), sessionIdParam()],
+			requestBody: {
+				required: true,
+				content: {
+					'application/json': {
+						schema: {
+							type: 'object',
+							required: ['content'],
+							properties: {
+								content: { type: 'string' },
+								agent: {
+									type: 'string',
+									description: 'Agent name. Defaults to config if omitted.',
+								},
+								provider: { $ref: '#/components/schemas/Provider' },
+								model: { type: 'string' },
+								userContext: {
+									type: 'string',
+									description:
+										'Optional user-provided context to include in the system prompt.',
+								},
+							},
+						},
+					},
+				},
+			},
+			responses: {
+				202: {
+					description: 'Accepted',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: { messageId: { type: 'string' } },
+								required: ['messageId'],
+							},
+						},
+					},
+				},
+				400: errorResponse(),
+			},
+		},
+	},
+} as const;

package/src/openapi/paths/sessions.ts

@@ -0,0 +1,90 @@
+import { errorResponse, projectQueryParam } from '../helpers';
+
+export const sessionsPaths = {
+	'/v1/sessions': {
+		get: {
+			tags: ['sessions'],
+			operationId: 'listSessions',
+			summary: 'List sessions',
+			parameters: [projectQueryParam()],
+			responses: {
+				200: {
+					description: 'OK',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'array',
+								items: { $ref: '#/components/schemas/Session' },
+							},
+						},
+					},
+				},
+			},
+		},
+		post: {
+			tags: ['sessions'],
+			operationId: 'createSession',
+			summary: 'Create a new session',
+			parameters: [projectQueryParam()],
+			requestBody: {
+				required: false,
+				content: {
+					'application/json': {
+						schema: {
+							type: 'object',
+							properties: {
+								title: { type: 'string', nullable: true },
+								agent: { type: 'string' },
+								provider: { $ref: '#/components/schemas/Provider' },
+								model: { type: 'string' },
+							},
+						},
+					},
+				},
+			},
+			responses: {
+				201: {
+					description: 'Created',
+					content: {
+						'application/json': {
+							schema: { $ref: '#/components/schemas/Session' },
+						},
+					},
+				},
+				400: errorResponse(),
+			},
+		},
+	},
+	'/v1/sessions/{sessionId}/abort': {
+		delete: {
+			tags: ['sessions'],
+			operationId: 'abortSession',
+			summary: 'Abort a running session',
+			description:
+				'Aborts any currently running assistant generation for the session',
+			parameters: [
+				{
+					in: 'path',
+					name: 'sessionId',
+					required: true,
+					schema: { type: 'string' },
+					description: 'Session ID to abort',
+				},
+			],
+			responses: {
+				200: {
+					description: 'OK',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: { success: { type: 'boolean' } },
+								required: ['success'],
+							},
+						},
+					},
+				},
+			},
+		},
+	},
+} as const;