@ottocode/server 0.1.212 → 0.1.215

package/src/openapi/paths/session-files.ts

@@ -0,0 +1,91 @@
+import { projectQueryParam } from '../helpers';
+
+export const sessionFilesPaths = {
+	'/v1/sessions/{sessionId}/files': {
+		get: {
+			tags: ['sessions'],
+			operationId: 'getSessionFiles',
+			summary: 'Get files modified in a session',
+			parameters: [
+				{
+					in: 'path',
+					name: 'sessionId',
+					required: true,
+					schema: { type: 'string' },
+				},
+				projectQueryParam(),
+			],
+			responses: {
+				200: {
+					description: 'OK',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: {
+									files: {
+										type: 'array',
+										items: {
+											type: 'object',
+											properties: {
+												path: { type: 'string' },
+												operationCount: { type: 'integer' },
+												firstModified: { type: 'integer' },
+												lastModified: { type: 'integer' },
+												operations: {
+													type: 'array',
+													items: {
+														type: 'object',
+														properties: {
+															path: { type: 'string' },
+															operation: {
+																type: 'string',
+																enum: ['write', 'patch', 'edit', 'create'],
+															},
+															timestamp: { type: 'integer' },
+															toolCallId: { type: 'string' },
+															toolName: { type: 'string' },
+														},
+														required: [
+															'path',
+															'operation',
+															'timestamp',
+															'toolCallId',
+															'toolName',
+														],
+													},
+												},
+											},
+											required: [
+												'path',
+												'operationCount',
+												'firstModified',
+												'lastModified',
+												'operations',
+											],
+										},
+									},
+									totalFiles: { type: 'integer' },
+									totalOperations: { type: 'integer' },
+								},
+								required: ['files', 'totalFiles', 'totalOperations'],
+							},
+						},
+					},
+				},
+				404: {
+					description: 'Session not found',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: { error: { type: 'string' } },
+								required: ['error'],
+							},
+						},
+					},
+				},
+			},
+		},
+	},
+} as const;

package/src/openapi/paths/setu.ts

@@ -151,4 +151,262 @@ export const setuPaths = {
 			},
 		},
 	},
+	'/v1/setu/topup/polar': {
+		post: {
+			tags: ['setu'],
+			operationId: 'createPolarCheckout',
+			summary: 'Create a Polar checkout for topping up',
+			requestBody: {
+				required: true,
+				content: {
+					'application/json': {
+						schema: {
+							type: 'object',
+							properties: {
+								amount: { type: 'number' },
+								successUrl: { type: 'string' },
+							},
+							required: ['amount', 'successUrl'],
+						},
+					},
+				},
+			},
+			responses: {
+				200: {
+					description: 'OK',
+					content: {
+						'application/json': {
+							schema: { type: 'object' },
+						},
+					},
+				},
+				401: {
+					description: 'Wallet not configured',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: { error: { type: 'string' } },
+								required: ['error'],
+							},
+						},
+					},
+				},
+			},
+		},
+	},
+	'/v1/setu/topup/select': {
+		post: {
+			tags: ['setu'],
+			operationId: 'selectTopupMethod',
+			summary: 'Select topup method for pending request',
+			requestBody: {
+				required: true,
+				content: {
+					'application/json': {
+						schema: {
+							type: 'object',
+							properties: {
+								sessionId: { type: 'string' },
+								method: {
+									type: 'string',
+									enum: ['crypto', 'fiat'],
+								},
+							},
+							required: ['sessionId', 'method'],
+						},
+					},
+				},
+			},
+			responses: {
+				200: {
+					description: 'OK',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: {
+									success: { type: 'boolean' },
+									method: { type: 'string' },
+								},
+								required: ['success', 'method'],
+							},
+						},
+					},
+				},
+				404: {
+					description: 'No pending topup',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: { error: { type: 'string' } },
+								required: ['error'],
+							},
+						},
+					},
+				},
+			},
+		},
+	},
+	'/v1/setu/topup/cancel': {
+		post: {
+			tags: ['setu'],
+			operationId: 'cancelTopup',
+			summary: 'Cancel pending topup',
+			requestBody: {
+				required: true,
+				content: {
+					'application/json': {
+						schema: {
+							type: 'object',
+							properties: {
+								sessionId: { type: 'string' },
+								reason: { type: 'string' },
+							},
+							required: ['sessionId'],
+						},
+					},
+				},
+			},
+			responses: {
+				200: {
+					description: 'OK',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: {
+									success: { type: 'boolean' },
+								},
+								required: ['success'],
+							},
+						},
+					},
+				},
+				404: {
+					description: 'No pending topup',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: { error: { type: 'string' } },
+								required: ['error'],
+							},
+						},
+					},
+				},
+			},
+		},
+	},
+	'/v1/setu/topup/pending': {
+		get: {
+			tags: ['setu'],
+			operationId: 'getPendingTopup',
+			summary: 'Get pending topup for a session',
+			parameters: [
+				{
+					in: 'query',
+					name: 'sessionId',
+					required: true,
+					schema: { type: 'string' },
+				},
+			],
+			responses: {
+				200: {
+					description: 'OK',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: {
+									hasPending: { type: 'boolean' },
+									sessionId: { type: 'string' },
+									messageId: { type: 'string' },
+									amountUsd: { type: 'number' },
+									currentBalance: { type: 'number' },
+									createdAt: { type: 'integer' },
+								},
+								required: ['hasPending'],
+							},
+						},
+					},
+				},
+			},
+		},
+	},
+	'/v1/setu/topup/polar/estimate': {
+		get: {
+			tags: ['setu'],
+			operationId: 'getPolarTopupEstimate',
+			summary: 'Get estimated fees for a Polar topup',
+			parameters: [
+				{
+					in: 'query',
+					name: 'amount',
+					required: true,
+					schema: { type: 'number' },
+					description: 'Amount in USD',
+				},
+			],
+			responses: {
+				200: {
+					description: 'OK',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: {
+									creditAmount: { type: 'number' },
+									chargeAmount: { type: 'number' },
+									feeAmount: { type: 'number' },
+									feeBreakdown: {
+										type: 'object',
+										properties: {
+											basePercent: { type: 'number' },
+											internationalPercent: { type: 'number' },
+											fixedCents: { type: 'number' },
+										},
+									},
+								},
+							},
+						},
+					},
+				},
+			},
+		},
+	},
+	'/v1/setu/topup/polar/status': {
+		get: {
+			tags: ['setu'],
+			operationId: 'getPolarTopupStatus',
+			summary: 'Get status of a Polar checkout',
+			parameters: [
+				{
+					in: 'query',
+					name: 'checkoutId',
+					required: true,
+					schema: { type: 'string' },
+				},
+			],
+			responses: {
+				200: {
+					description: 'OK',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: {
+									checkoutId: { type: 'string' },
+									confirmed: { type: 'boolean' },
+									amountUsd: { type: 'number', nullable: true },
+									confirmedAt: { type: 'string', nullable: true },
+								},
+							},
+						},
+					},
+				},
+			},
+		},
+	},
 } as const;

package/src/openapi/paths/skills.ts

@@ -0,0 +1,172 @@
+import { errorResponse, projectQueryParam } from '../helpers';
+
+export const skillsPaths = {
+	'/v1/skills': {
+		get: {
+			tags: ['config'],
+			operationId: 'listSkills',
+			summary: 'List discovered skills',
+			parameters: [projectQueryParam()],
+			responses: {
+				200: {
+					description: 'OK',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: {
+									skills: {
+										type: 'array',
+										items: {
+											type: 'object',
+											properties: {
+												name: { type: 'string' },
+												description: { type: 'string' },
+												scope: { type: 'string' },
+												path: { type: 'string' },
+											},
+											required: ['name', 'description', 'scope', 'path'],
+										},
+									},
+								},
+								required: ['skills'],
+							},
+						},
+					},
+				},
+				500: errorResponse(),
+			},
+		},
+	},
+	'/v1/skills/{name}': {
+		get: {
+			tags: ['config'],
+			operationId: 'getSkill',
+			summary: 'Get a skill by name',
+			parameters: [
+				{
+					in: 'path',
+					name: 'name',
+					required: true,
+					schema: { type: 'string' },
+				},
+				projectQueryParam(),
+			],
+			responses: {
+				200: {
+					description: 'OK',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: {
+									name: { type: 'string' },
+									description: { type: 'string' },
+									license: {
+										type: 'string',
+										nullable: true,
+									},
+									compatibility: {
+										type: 'string',
+										nullable: true,
+									},
+									metadata: {
+										type: 'object',
+										nullable: true,
+									},
+									allowedTools: {
+										type: 'array',
+										items: { type: 'string' },
+										nullable: true,
+									},
+									path: { type: 'string' },
+									scope: { type: 'string' },
+									content: { type: 'string' },
+								},
+								required: ['name', 'description', 'path', 'scope', 'content'],
+							},
+						},
+					},
+				},
+				404: errorResponse(),
+				500: errorResponse(),
+			},
+		},
+	},
+	'/v1/skills/validate': {
+		post: {
+			tags: ['config'],
+			operationId: 'validateSkill',
+			summary: 'Validate a SKILL.md content',
+			requestBody: {
+				required: true,
+				content: {
+					'application/json': {
+						schema: {
+							type: 'object',
+							properties: {
+								content: { type: 'string' },
+								path: { type: 'string' },
+							},
+							required: ['content'],
+						},
+					},
+				},
+			},
+			responses: {
+				200: {
+					description: 'OK',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: {
+									valid: { type: 'boolean' },
+									name: { type: 'string' },
+									description: { type: 'string' },
+									license: {
+										type: 'string',
+										nullable: true,
+									},
+									error: { type: 'string' },
+								},
+								required: ['valid'],
+							},
+						},
+					},
+				},
+			},
+		},
+	},
+	'/v1/skills/validate-name/{name}': {
+		get: {
+			tags: ['config'],
+			operationId: 'validateSkillName',
+			summary: 'Check if a skill name is valid',
+			parameters: [
+				{
+					in: 'path',
+					name: 'name',
+					required: true,
+					schema: { type: 'string' },
+				},
+			],
+			responses: {
+				200: {
+					description: 'OK',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: {
+									valid: { type: 'boolean' },
+								},
+								required: ['valid'],
+							},
+						},
+					},
+				},
+			},
+		},
+	},
+} as const;

package/src/openapi/paths/tunnel.ts

@@ -0,0 +1,163 @@
+import { errorResponse } from '../helpers';
+
+export const tunnelPaths = {
+	'/v1/tunnel/status': {
+		get: {
+			tags: ['tunnel'],
+			operationId: 'getTunnelStatus',
+			summary: 'Get tunnel status',
+			responses: {
+				200: {
+					description: 'OK',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: {
+									status: {
+										type: 'string',
+										enum: ['idle', 'starting', 'connected', 'error'],
+									},
+									url: { type: 'string', nullable: true },
+									error: { type: 'string', nullable: true },
+									binaryInstalled: { type: 'boolean' },
+									isRunning: { type: 'boolean' },
+								},
+								required: ['status', 'binaryInstalled', 'isRunning'],
+							},
+						},
+					},
+				},
+			},
+		},
+	},
+	'/v1/tunnel/start': {
+		post: {
+			tags: ['tunnel'],
+			operationId: 'startTunnel',
+			summary: 'Start a tunnel',
+			requestBody: {
+				required: false,
+				content: {
+					'application/json': {
+						schema: {
+							type: 'object',
+							properties: {
+								port: { type: 'integer' },
+							},
+						},
+					},
+				},
+			},
+			responses: {
+				200: {
+					description: 'OK',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: {
+									ok: { type: 'boolean' },
+									url: { type: 'string' },
+									message: { type: 'string' },
+									error: { type: 'string' },
+								},
+								required: ['ok'],
+							},
+						},
+					},
+				},
+			},
+		},
+	},
+	'/v1/tunnel/register': {
+		post: {
+			tags: ['tunnel'],
+			operationId: 'registerTunnel',
+			summary: 'Register an external tunnel URL',
+			requestBody: {
+				required: true,
+				content: {
+					'application/json': {
+						schema: {
+							type: 'object',
+							properties: {
+								url: { type: 'string' },
+							},
+							required: ['url'],
+						},
+					},
+				},
+			},
+			responses: {
+				200: {
+					description: 'OK',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: {
+									ok: { type: 'boolean' },
+									url: { type: 'string' },
+									message: { type: 'string' },
+								},
+								required: ['ok'],
+							},
+						},
+					},
+				},
+				400: errorResponse(),
+			},
+		},
+	},
+	'/v1/tunnel/stop': {
+		post: {
+			tags: ['tunnel'],
+			operationId: 'stopTunnel',
+			summary: 'Stop the tunnel',
+			responses: {
+				200: {
+					description: 'OK',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: {
+									ok: { type: 'boolean' },
+									message: { type: 'string' },
+								},
+								required: ['ok'],
+							},
+						},
+					},
+				},
+			},
+		},
+	},
+	'/v1/tunnel/qr': {
+		get: {
+			tags: ['tunnel'],
+			operationId: 'getTunnelQR',
+			summary: 'Get QR code for tunnel URL',
+			responses: {
+				200: {
+					description: 'OK',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: {
+									ok: { type: 'boolean' },
+									url: { type: 'string' },
+									qrCode: { type: 'string' },
+								},
+								required: ['ok'],
+							},
+						},
+					},
+				},
+				400: errorResponse(),
+			},
+		},
+	},
+} as const;