@ottocode/server 0.1.173

package/src/openapi/paths/setu.ts

@@ -0,0 +1,154 @@
+export const setuPaths = {
+	'/v1/setu/balance': {
+		get: {
+			tags: ['setu'],
+			operationId: 'getSetuBalance',
+			summary: 'Get Setu account balance',
+			description:
+				'Returns wallet balance, total spent, total topups, and request count',
+			responses: {
+				200: {
+					description: 'OK',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: {
+									walletAddress: { type: 'string' },
+									balance: { type: 'number' },
+									totalSpent: { type: 'number' },
+									totalTopups: { type: 'number' },
+									requestCount: { type: 'number' },
+								},
+								required: [
+									'walletAddress',
+									'balance',
+									'totalSpent',
+									'totalTopups',
+									'requestCount',
+								],
+							},
+						},
+					},
+				},
+				401: {
+					description: 'Wallet not configured',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: { error: { type: 'string' } },
+								required: ['error'],
+							},
+						},
+					},
+				},
+				502: {
+					description: 'Failed to fetch balance from Setu',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: { error: { type: 'string' } },
+								required: ['error'],
+							},
+						},
+					},
+				},
+			},
+		},
+	},
+	'/v1/setu/wallet': {
+		get: {
+			tags: ['setu'],
+			operationId: 'getSetuWallet',
+			summary: 'Get Setu wallet info',
+			description:
+				'Returns whether the wallet is configured and its public key',
+			responses: {
+				200: {
+					description: 'OK',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: {
+									configured: { type: 'boolean' },
+									publicKey: { type: 'string' },
+									error: { type: 'string' },
+								},
+								required: ['configured'],
+							},
+						},
+					},
+				},
+			},
+		},
+	},
+	'/v1/setu/usdc-balance': {
+		get: {
+			tags: ['setu'],
+			operationId: 'getSetuUsdcBalance',
+			summary: 'Get USDC token balance',
+			description:
+				'Fetches USDC balance from Solana blockchain for the configured wallet',
+			parameters: [
+				{
+					in: 'query',
+					name: 'network',
+					schema: {
+						type: 'string',
+						enum: ['mainnet', 'devnet'],
+						default: 'mainnet',
+					},
+					description: 'Solana network to query',
+				},
+			],
+			responses: {
+				200: {
+					description: 'OK',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: {
+									walletAddress: { type: 'string' },
+									usdcBalance: { type: 'number' },
+									network: {
+										type: 'string',
+										enum: ['mainnet', 'devnet'],
+									},
+								},
+								required: ['walletAddress', 'usdcBalance', 'network'],
+							},
+						},
+					},
+				},
+				401: {
+					description: 'Wallet not configured',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: { error: { type: 'string' } },
+								required: ['error'],
+							},
+						},
+					},
+				},
+				502: {
+					description: 'Failed to fetch USDC balance from Solana',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: { error: { type: 'string' } },
+								required: ['error'],
+							},
+						},
+					},
+				},
+			},
+		},
+	},
+} as const;

package/src/openapi/paths/stream.ts

@@ -0,0 +1,26 @@
+import { projectQueryParam, sessionIdParam } from '../helpers';
+
+export const streamPaths = {
+	'/v1/sessions/{id}/stream': {
+		get: {
+			tags: ['stream'],
+			operationId: 'subscribeSessionStream',
+			summary: 'Subscribe to session event stream (SSE)',
+			parameters: [projectQueryParam(), sessionIdParam()],
+			responses: {
+				200: {
+					description: 'text/event-stream',
+					content: {
+						'text/event-stream': {
+							schema: {
+								type: 'string',
+								description:
+									'SSE event stream. Events include session.created, message.created, message.part.delta, tool.call, tool.delta, tool.result, message.completed, error.',
+							},
+						},
+					},
+				},
+			},
+		},
+	},
+} as const;

package/src/openapi/paths/terminals.ts

@@ -0,0 +1,226 @@
+export const terminalsPath = {
+	'/v1/terminals': {
+		get: {
+			operationId: 'getTerminals',
+			summary: 'List all terminals',
+			description: 'Get a list of all active terminal sessions',
+			responses: {
+				'200': {
+					description: 'List of terminals',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: {
+									terminals: {
+										type: 'array',
+										items: {
+											$ref: '#/components/schemas/Terminal',
+										},
+									},
+									count: {
+										type: 'integer',
+									},
+								},
+							},
+						},
+					},
+				},
+			},
+		},
+		post: {
+			operationId: 'postTerminals',
+			summary: 'Create a new terminal',
+			description: 'Spawn a new terminal process',
+			requestBody: {
+				required: true,
+				content: {
+					'application/json': {
+						schema: {
+							type: 'object',
+							required: ['command', 'purpose'],
+							properties: {
+								command: {
+									type: 'string',
+									description: 'Command to execute',
+								},
+								args: {
+									type: 'array',
+									items: { type: 'string' },
+									description: 'Command arguments',
+								},
+								purpose: {
+									type: 'string',
+									description: 'Description of terminal purpose',
+								},
+								cwd: {
+									type: 'string',
+									description: 'Working directory',
+								},
+								title: {
+									type: 'string',
+									description: 'Terminal title',
+								},
+							},
+						},
+					},
+				},
+			},
+			responses: {
+				'200': {
+					description: 'Terminal created',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: {
+									terminalId: { type: 'string' },
+									pid: { type: 'integer' },
+									purpose: { type: 'string' },
+									command: { type: 'string' },
+								},
+							},
+						},
+					},
+				},
+			},
+		},
+	},
+	'/v1/terminals/{id}': {
+		get: {
+			operationId: 'getTerminalsById',
+			summary: 'Get terminal details',
+			description: 'Get information about a specific terminal',
+			parameters: [
+				{
+					name: 'id',
+					in: 'path',
+					required: true,
+					schema: { type: 'string' },
+				},
+			],
+			responses: {
+				'200': {
+					description: 'Terminal details',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: {
+									terminal: {
+										$ref: '#/components/schemas/Terminal',
+									},
+								},
+							},
+						},
+					},
+				},
+				'404': {
+					description: 'Terminal not found',
+				},
+			},
+		},
+		delete: {
+			operationId: 'deleteTerminalsById',
+			summary: 'Kill terminal',
+			description: 'Terminate a running terminal process',
+			parameters: [
+				{
+					name: 'id',
+					in: 'path',
+					required: true,
+					schema: { type: 'string' },
+				},
+			],
+			responses: {
+				'200': {
+					description: 'Terminal killed',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: {
+									success: { type: 'boolean' },
+								},
+							},
+						},
+					},
+				},
+			},
+		},
+	},
+	'/v1/terminals/{id}/output': {
+		get: {
+			operationId: 'getTerminalsByIdOutput',
+			summary: 'Stream terminal output',
+			description: 'Get real-time terminal output via SSE',
+			parameters: [
+				{
+					name: 'id',
+					in: 'path',
+					required: true,
+					schema: { type: 'string' },
+				},
+			],
+			responses: {
+				'200': {
+					description: 'SSE stream of terminal output',
+					content: {
+						'text/event-stream': {
+							schema: {
+								type: 'string',
+							},
+						},
+					},
+				},
+			},
+		},
+	},
+	'/v1/terminals/{id}/input': {
+		post: {
+			operationId: 'postTerminalsByIdInput',
+			summary: 'Send input to terminal',
+			description: 'Write data to terminal stdin',
+			parameters: [
+				{
+					name: 'id',
+					in: 'path',
+					required: true,
+					schema: { type: 'string' },
+				},
+			],
+			requestBody: {
+				required: true,
+				content: {
+					'application/json': {
+						schema: {
+							type: 'object',
+							required: ['input'],
+							properties: {
+								input: {
+									type: 'string',
+									description: 'Input to send to terminal',
+								},
+							},
+						},
+					},
+				},
+			},
+			responses: {
+				'200': {
+					description: 'Input sent',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: {
+									success: { type: 'boolean' },
+								},
+							},
+						},
+					},
+				},
+			},
+		},
+	},
+};