@ottocode/server 0.1.213 → 0.1.216

package/src/openapi/paths/provider-usage.ts

@@ -0,0 +1,59 @@
+import { errorResponse } from '../helpers';
+
+export const providerUsagePaths = {
+	'/v1/provider-usage/{provider}': {
+		get: {
+			tags: ['config'],
+			operationId: 'getProviderUsage',
+			summary: 'Get usage information for an OAuth provider',
+			parameters: [
+				{
+					in: 'path',
+					name: 'provider',
+					required: true,
+					schema: { type: 'string', enum: ['anthropic', 'openai'] },
+				},
+			],
+			responses: {
+				200: {
+					description: 'OK',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: {
+									provider: { type: 'string' },
+									primaryWindow: {
+										type: 'object',
+										nullable: true,
+										properties: {
+											usedPercent: { type: 'number' },
+											windowSeconds: { type: 'integer' },
+											resetsAt: { type: 'string', nullable: true },
+											resetAfterSeconds: { type: 'integer' },
+										},
+									},
+									secondaryWindow: {
+										type: 'object',
+										nullable: true,
+										properties: {
+											usedPercent: { type: 'number' },
+											windowSeconds: { type: 'integer' },
+											resetsAt: { type: 'string', nullable: true },
+											resetAfterSeconds: { type: 'integer' },
+										},
+									},
+									limitReached: { type: 'boolean' },
+									planType: { type: 'string', nullable: true },
+								},
+								required: ['provider', 'limitReached'],
+							},
+						},
+					},
+				},
+				400: errorResponse(),
+				404: errorResponse(),
+			},
+		},
+	},
+} as const;

package/src/openapi/paths/research.ts

@@ -0,0 +1,227 @@
+import { errorResponse, projectQueryParam } from '../helpers';
+
+export const researchPaths = {
+	'/v1/sessions/{parentId}/research': {
+		get: {
+			tags: ['sessions'],
+			operationId: 'listResearchSessions',
+			summary: 'List research sessions for a parent',
+			parameters: [
+				{
+					in: 'path',
+					name: 'parentId',
+					required: true,
+					schema: { type: 'string' },
+				},
+				projectQueryParam(),
+			],
+			responses: {
+				200: {
+					description: 'OK',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: {
+									sessions: {
+										type: 'array',
+										items: { $ref: '#/components/schemas/Session' },
+									},
+								},
+								required: ['sessions'],
+							},
+						},
+					},
+				},
+				404: errorResponse(),
+			},
+		},
+		post: {
+			tags: ['sessions'],
+			operationId: 'createResearchSession',
+			summary: 'Create a research session',
+			parameters: [
+				{
+					in: 'path',
+					name: 'parentId',
+					required: true,
+					schema: { type: 'string' },
+				},
+				projectQueryParam(),
+			],
+			requestBody: {
+				required: false,
+				content: {
+					'application/json': {
+						schema: {
+							type: 'object',
+							properties: {
+								provider: { type: 'string' },
+								model: { type: 'string' },
+								title: { type: 'string' },
+							},
+						},
+					},
+				},
+			},
+			responses: {
+				201: {
+					description: 'Created',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: {
+									session: { $ref: '#/components/schemas/Session' },
+									parentSessionId: { type: 'string' },
+								},
+								required: ['session', 'parentSessionId'],
+							},
+						},
+					},
+				},
+				404: errorResponse(),
+			},
+		},
+	},
+	'/v1/research/{researchId}': {
+		delete: {
+			tags: ['sessions'],
+			operationId: 'deleteResearchSession',
+			summary: 'Delete a research session',
+			parameters: [
+				{
+					in: 'path',
+					name: 'researchId',
+					required: true,
+					schema: { type: 'string' },
+				},
+				projectQueryParam(),
+			],
+			responses: {
+				200: {
+					description: 'OK',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: { success: { type: 'boolean' } },
+								required: ['success'],
+							},
+						},
+					},
+				},
+				400: errorResponse(),
+				404: errorResponse(),
+			},
+		},
+	},
+	'/v1/sessions/{parentId}/inject': {
+		post: {
+			tags: ['sessions'],
+			operationId: 'injectResearchContext',
+			summary: 'Inject research context into parent session',
+			parameters: [
+				{
+					in: 'path',
+					name: 'parentId',
+					required: true,
+					schema: { type: 'string' },
+				},
+				projectQueryParam(),
+			],
+			requestBody: {
+				required: true,
+				content: {
+					'application/json': {
+						schema: {
+							type: 'object',
+							properties: {
+								researchSessionId: { type: 'string' },
+								label: { type: 'string' },
+							},
+							required: ['researchSessionId'],
+						},
+					},
+				},
+			},
+			responses: {
+				200: {
+					description: 'OK',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: {
+									content: { type: 'string' },
+									label: { type: 'string' },
+									sessionId: { type: 'string' },
+									parentSessionId: { type: 'string' },
+									tokenEstimate: { type: 'integer' },
+								},
+								required: [
+									'content',
+									'label',
+									'sessionId',
+									'parentSessionId',
+									'tokenEstimate',
+								],
+							},
+						},
+					},
+				},
+				400: errorResponse(),
+				404: errorResponse(),
+			},
+		},
+	},
+	'/v1/research/{researchId}/export': {
+		post: {
+			tags: ['sessions'],
+			operationId: 'exportResearchSession',
+			summary: 'Export research session to a new main session',
+			parameters: [
+				{
+					in: 'path',
+					name: 'researchId',
+					required: true,
+					schema: { type: 'string' },
+				},
+				projectQueryParam(),
+			],
+			requestBody: {
+				required: false,
+				content: {
+					'application/json': {
+						schema: {
+							type: 'object',
+							properties: {
+								provider: { type: 'string' },
+								model: { type: 'string' },
+								agent: { type: 'string' },
+							},
+						},
+					},
+				},
+			},
+			responses: {
+				201: {
+					description: 'Created',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: {
+									newSession: { $ref: '#/components/schemas/Session' },
+									injectedContext: { type: 'string' },
+								},
+								required: ['newSession', 'injectedContext'],
+							},
+						},
+					},
+				},
+				404: errorResponse(),
+			},
+		},
+	},
+} as const;

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

@@ -0,0 +1,93 @@
+import { errorResponse } from '../helpers';
+
+const sessionIdParam = {
+	in: 'path',
+	name: 'id',
+	required: true,
+	schema: { type: 'string' },
+} as const;
+
+export const sessionApprovalPaths = {
+	'/v1/sessions/{id}/approval': {
+		post: {
+			tags: ['sessions'],
+			operationId: 'resolveApproval',
+			summary: 'Approve or deny a tool execution',
+			parameters: [sessionIdParam],
+			requestBody: {
+				required: true,
+				content: {
+					'application/json': {
+						schema: {
+							type: 'object',
+							properties: {
+								callId: { type: 'string' },
+								approved: { type: 'boolean' },
+							},
+							required: ['callId', 'approved'],
+						},
+					},
+				},
+			},
+			responses: {
+				200: {
+					description: 'OK',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: {
+									ok: { type: 'boolean' },
+									callId: { type: 'string' },
+									approved: { type: 'boolean' },
+								},
+								required: ['ok', 'callId', 'approved'],
+							},
+						},
+					},
+				},
+				400: errorResponse(),
+				403: errorResponse(),
+				404: errorResponse(),
+			},
+		},
+	},
+	'/v1/sessions/{id}/approval/pending': {
+		get: {
+			tags: ['sessions'],
+			operationId: 'getPendingApprovals',
+			summary: 'Get pending approvals for a session',
+			parameters: [sessionIdParam],
+			responses: {
+				200: {
+					description: 'OK',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: {
+									ok: { type: 'boolean' },
+									pending: {
+										type: 'array',
+										items: {
+											type: 'object',
+											properties: {
+												callId: { type: 'string' },
+												toolName: { type: 'string' },
+												args: { type: 'object' },
+												messageId: { type: 'string' },
+												createdAt: { type: 'integer' },
+											},
+											required: ['callId', 'toolName', 'createdAt'],
+										},
+									},
+								},
+								required: ['ok', 'pending'],
+							},
+						},
+					},
+				},
+			},
+		},
+	},
+} as const;

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

@@ -0,0 +1,336 @@
+import { errorResponse, projectQueryParam } from '../helpers';
+
+const sessionIdParam = {
+	in: 'path',
+	name: 'sessionId',
+	required: true,
+	schema: { type: 'string' },
+} as const;
+
+export const sessionExtrasPaths = {
+	'/v1/sessions/{sessionId}': {
+		patch: {
+			tags: ['sessions'],
+			operationId: 'updateSession',
+			summary: 'Update session preferences',
+			parameters: [sessionIdParam, projectQueryParam()],
+			requestBody: {
+				required: true,
+				content: {
+					'application/json': {
+						schema: {
+							type: 'object',
+							properties: {
+								agent: { type: 'string' },
+								provider: { type: 'string' },
+								model: { type: 'string' },
+							},
+						},
+					},
+				},
+			},
+			responses: {
+				200: {
+					description: 'OK',
+					content: {
+						'application/json': {
+							schema: { $ref: '#/components/schemas/Session' },
+						},
+					},
+				},
+				400: errorResponse(),
+				404: errorResponse(),
+			},
+		},
+		delete: {
+			tags: ['sessions'],
+			operationId: 'deleteSession',
+			summary: 'Delete a session and all its messages',
+			parameters: [sessionIdParam, projectQueryParam()],
+			responses: {
+				200: {
+					description: 'OK',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: { success: { type: 'boolean' } },
+								required: ['success'],
+							},
+						},
+					},
+				},
+				404: errorResponse(),
+			},
+		},
+	},
+	'/v1/sessions/{sessionId}/queue': {
+		get: {
+			tags: ['sessions'],
+			operationId: 'getSessionQueue',
+			summary: 'Get queue state for a session',
+			parameters: [sessionIdParam],
+			responses: {
+				200: {
+					description: 'OK',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: {
+									currentMessageId: {
+										type: 'string',
+										nullable: true,
+									},
+									queuedMessages: {
+										type: 'array',
+										items: {
+											type: 'object',
+											properties: {
+												assistantMessageId: { type: 'string' },
+												agent: { type: 'string' },
+												provider: { type: 'string' },
+												model: { type: 'string' },
+											},
+										},
+									},
+									isRunning: { type: 'boolean' },
+								},
+								required: ['currentMessageId', 'queuedMessages', 'isRunning'],
+							},
+						},
+					},
+				},
+			},
+		},
+	},
+	'/v1/sessions/{sessionId}/queue/{messageId}': {
+		delete: {
+			tags: ['sessions'],
+			operationId: 'removeFromQueue',
+			summary: 'Remove a message from session queue',
+			parameters: [
+				sessionIdParam,
+				{
+					in: 'path',
+					name: 'messageId',
+					required: true,
+					schema: { type: 'string' },
+				},
+				projectQueryParam(),
+			],
+			responses: {
+				200: {
+					description: 'OK',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: {
+									success: { type: 'boolean' },
+									removed: { type: 'boolean' },
+									wasQueued: { type: 'boolean' },
+									wasRunning: { type: 'boolean' },
+									wasStored: { type: 'boolean' },
+								},
+								required: ['success'],
+							},
+						},
+					},
+				},
+				404: errorResponse(),
+			},
+		},
+	},
+	'/v1/sessions/{sessionId}/messages/{messageId}/retry': {
+		post: {
+			tags: ['sessions'],
+			operationId: 'retryMessage',
+			summary: 'Retry a failed assistant message',
+			parameters: [
+				sessionIdParam,
+				{
+					in: 'path',
+					name: 'messageId',
+					required: true,
+					schema: { type: 'string' },
+				},
+				projectQueryParam(),
+			],
+			responses: {
+				200: {
+					description: 'OK',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: {
+									success: { type: 'boolean' },
+									messageId: { type: 'string' },
+								},
+								required: ['success', 'messageId'],
+							},
+						},
+					},
+				},
+				400: errorResponse(),
+				404: errorResponse(),
+			},
+		},
+	},
+	'/v1/sessions/{sessionId}/share': {
+		get: {
+			tags: ['sessions'],
+			operationId: 'getShareStatus',
+			summary: 'Get share status for a session',
+			parameters: [sessionIdParam, projectQueryParam()],
+			responses: {
+				200: {
+					description: 'OK',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: {
+									shared: { type: 'boolean' },
+									shareId: { type: 'string' },
+									url: { type: 'string' },
+									title: { type: 'string', nullable: true },
+									createdAt: { type: 'integer' },
+									lastSyncedAt: { type: 'integer' },
+									lastSyncedMessageId: { type: 'string' },
+									syncedMessages: { type: 'integer' },
+									totalMessages: { type: 'integer' },
+									pendingMessages: { type: 'integer' },
+									isSynced: { type: 'boolean' },
+								},
+								required: ['shared'],
+							},
+						},
+					},
+				},
+			},
+		},
+		post: {
+			tags: ['sessions'],
+			operationId: 'shareSession',
+			summary: 'Share a session',
+			parameters: [sessionIdParam, projectQueryParam()],
+			responses: {
+				200: {
+					description: 'OK',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: {
+									shared: { type: 'boolean' },
+									shareId: { type: 'string' },
+									url: { type: 'string' },
+									message: { type: 'string' },
+								},
+								required: ['shared'],
+							},
+						},
+					},
+				},
+				400: errorResponse(),
+				404: errorResponse(),
+			},
+		},
+		put: {
+			tags: ['sessions'],
+			operationId: 'syncShare',
+			summary: 'Sync shared session with new messages',
+			parameters: [sessionIdParam, projectQueryParam()],
+			responses: {
+				200: {
+					description: 'OK',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: {
+									synced: { type: 'boolean' },
+									url: { type: 'string' },
+									newMessages: { type: 'integer' },
+									message: { type: 'string' },
+								},
+								required: ['synced'],
+							},
+						},
+					},
+				},
+				400: errorResponse(),
+			},
+		},
+		delete: {
+			tags: ['sessions'],
+			operationId: 'deleteShare',
+			summary: 'Delete a shared session',
+			parameters: [sessionIdParam, projectQueryParam()],
+			responses: {
+				200: {
+					description: 'OK',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: {
+									deleted: { type: 'boolean' },
+									sessionId: { type: 'string' },
+								},
+								required: ['deleted', 'sessionId'],
+							},
+						},
+					},
+				},
+				404: errorResponse(),
+			},
+		},
+	},
+	'/v1/shares': {
+		get: {
+			tags: ['sessions'],
+			operationId: 'listShares',
+			summary: 'List all shared sessions for a project',
+			parameters: [projectQueryParam()],
+			responses: {
+				200: {
+					description: 'OK',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: {
+									shares: {
+										type: 'array',
+										items: {
+											type: 'object',
+											properties: {
+												sessionId: { type: 'string' },
+												shareId: { type: 'string' },
+												url: { type: 'string' },
+												title: { type: 'string', nullable: true },
+												createdAt: { type: 'integer' },
+												lastSyncedAt: { type: 'integer' },
+											},
+											required: [
+												'sessionId',
+												'shareId',
+												'url',
+												'createdAt',
+												'lastSyncedAt',
+											],
+										},
+									},
+								},
+								required: ['shares'],
+							},
+						},
+					},
+				},
+			},
+		},
+	},
+} as const;