@ottocode/server 0.1.173

package/src/openapi/schemas.ts

@@ -0,0 +1,345 @@
+import { providerIds } from '@ottocode/sdk';
+
+export const schemas = {
+	Provider: {
+		type: 'string',
+		enum: providerIds,
+	},
+	AskResponse: {
+		type: 'object',
+		properties: {
+			sessionId: { type: 'string' },
+			header: { $ref: '#/components/schemas/AskResponseHeader' },
+			provider: { $ref: '#/components/schemas/Provider' },
+			model: { type: 'string' },
+			agent: { type: 'string' },
+			assistantMessageId: { type: 'string' },
+			message: {
+				$ref: '#/components/schemas/AskResponseMessage',
+				nullable: true,
+				description:
+					'Present when the request created a new session or reused the last session for the project.',
+			},
+		},
+		required: [
+			'sessionId',
+			'header',
+			'provider',
+			'model',
+			'agent',
+			'assistantMessageId',
+		],
+	},
+	AskResponseHeader: {
+		type: 'object',
+		properties: {
+			sessionId: { type: 'string' },
+			agent: { type: 'string', nullable: true },
+			provider: {
+				$ref: '#/components/schemas/Provider',
+				nullable: true,
+			},
+			model: { type: 'string', nullable: true },
+		},
+		required: ['sessionId'],
+	},
+	AskResponseMessage: {
+		type: 'object',
+		properties: {
+			kind: { type: 'string', enum: ['created', 'last'] },
+			sessionId: { type: 'string' },
+		},
+		required: ['kind', 'sessionId'],
+	},
+	Session: {
+		type: 'object',
+		properties: {
+			id: { type: 'string' },
+			title: { type: 'string', nullable: true },
+			agent: { type: 'string' },
+			provider: { $ref: '#/components/schemas/Provider' },
+			model: { type: 'string' },
+			projectPath: { type: 'string' },
+			createdAt: { type: 'integer', format: 'int64' },
+			lastActiveAt: { type: 'integer', format: 'int64', nullable: true },
+			totalInputTokens: { type: 'integer', nullable: true },
+			totalOutputTokens: { type: 'integer', nullable: true },
+			totalCachedTokens: { type: 'integer', nullable: true },
+			totalCacheCreationTokens: { type: 'integer', nullable: true },
+			totalToolTimeMs: { type: 'integer', nullable: true },
+			toolCounts: {
+				type: 'object',
+				additionalProperties: { type: 'integer' },
+				nullable: true,
+			},
+		},
+		required: ['id', 'agent', 'provider', 'model', 'projectPath', 'createdAt'],
+	},
+	Message: {
+		type: 'object',
+		properties: {
+			id: { type: 'string' },
+			sessionId: { type: 'string' },
+			role: {
+				type: 'string',
+				enum: ['system', 'user', 'assistant', 'tool'],
+			},
+			status: { type: 'string', enum: ['pending', 'complete', 'error'] },
+			agent: { type: 'string' },
+			provider: { $ref: '#/components/schemas/Provider' },
+			model: { type: 'string' },
+			createdAt: { type: 'integer', format: 'int64' },
+			completedAt: { type: 'integer', format: 'int64', nullable: true },
+			latencyMs: { type: 'integer', nullable: true },
+			inputTokens: { type: 'integer', nullable: true },
+			outputTokens: { type: 'integer', nullable: true },
+			totalTokens: { type: 'integer', nullable: true },
+			error: { type: 'string', nullable: true },
+		},
+		required: [
+			'id',
+			'sessionId',
+			'role',
+			'status',
+			'agent',
+			'provider',
+			'model',
+			'createdAt',
+		],
+	},
+	MessagePart: {
+		type: 'object',
+		properties: {
+			id: { type: 'string' },
+			messageId: { type: 'string' },
+			index: { type: 'integer', format: 'int64' },
+			type: {
+				type: 'string',
+				enum: ['text', 'tool_call', 'tool_result', 'image', 'error'],
+			},
+			content: {
+				type: 'string',
+				description:
+					'JSON-encoded content. For text: {"text": string}. For tool_call: {"name": string, "args": object}. For tool_result: {"name": string, "result"?: any, "artifact"?: Artifact}.',
+			},
+			agent: { type: 'string' },
+			provider: { $ref: '#/components/schemas/Provider' },
+			model: { type: 'string' },
+			startedAt: { type: 'integer', format: 'int64', nullable: true },
+			completedAt: { type: 'integer', format: 'int64', nullable: true },
+			toolName: { type: 'string', nullable: true },
+			toolCallId: { type: 'string', nullable: true },
+			toolDurationMs: { type: 'integer', nullable: true },
+		},
+		required: [
+			'id',
+			'messageId',
+			'index',
+			'type',
+			'content',
+			'agent',
+			'provider',
+			'model',
+		],
+	},
+	Artifact: {
+		oneOf: [
+			{ $ref: '#/components/schemas/FileDiffArtifact' },
+			{ $ref: '#/components/schemas/FileArtifact' },
+		],
+	},
+	FileDiffArtifact: {
+		type: 'object',
+		properties: {
+			kind: { type: 'string', enum: ['file_diff'] },
+			patchFormat: { type: 'string', enum: ['unified'] },
+			patch: { type: 'string' },
+			summary: {
+				type: 'object',
+				properties: {
+					files: { type: 'integer' },
+					additions: { type: 'integer' },
+					deletions: { type: 'integer' },
+				},
+				additionalProperties: false,
+			},
+		},
+		required: ['kind', 'patchFormat', 'patch'],
+	},
+	FileArtifact: {
+		type: 'object',
+		properties: {
+			kind: { type: 'string', enum: ['file'] },
+			path: { type: 'string' },
+			mime: { type: 'string' },
+			size: { type: 'integer' },
+			sha256: { type: 'string' },
+		},
+		required: ['kind', 'path'],
+	},
+	Config: {
+		type: 'object',
+		properties: {
+			agents: {
+				type: 'array',
+				items: { type: 'string' },
+			},
+			providers: {
+				type: 'array',
+				items: { $ref: '#/components/schemas/Provider' },
+			},
+			defaults: {
+				type: 'object',
+				properties: {
+					agent: { type: 'string' },
+					provider: { $ref: '#/components/schemas/Provider' },
+					model: { type: 'string' },
+				},
+				required: ['agent', 'provider', 'model'],
+			},
+		},
+		required: ['agents', 'providers', 'defaults'],
+	},
+	Model: {
+		type: 'object',
+		properties: {
+			id: { type: 'string' },
+			label: { type: 'string' },
+			toolCall: { type: 'boolean' },
+			reasoningText: { type: 'boolean' },
+		},
+		required: ['id', 'label'],
+	},
+	GitStatus: {
+		type: 'object',
+		properties: {
+			branch: { type: 'string' },
+			ahead: { type: 'integer' },
+			behind: { type: 'integer' },
+			staged: {
+				type: 'array',
+				items: { $ref: '#/components/schemas/GitFile' },
+			},
+			unstaged: {
+				type: 'array',
+				items: { $ref: '#/components/schemas/GitFile' },
+			},
+			untracked: {
+				type: 'array',
+				items: { $ref: '#/components/schemas/GitFile' },
+			},
+			conflicted: {
+				type: 'array',
+				items: { $ref: '#/components/schemas/GitFile' },
+			},
+			hasChanges: { type: 'boolean' },
+			hasConflicts: { type: 'boolean' },
+		},
+		required: [
+			'branch',
+			'ahead',
+			'behind',
+			'staged',
+			'unstaged',
+			'untracked',
+			'conflicted',
+			'hasChanges',
+			'hasConflicts',
+		],
+	},
+	GitFile: {
+		type: 'object',
+		properties: {
+			path: { type: 'string' },
+			status: {
+				type: 'string',
+				enum: [
+					'modified',
+					'added',
+					'deleted',
+					'renamed',
+					'untracked',
+					'conflicted',
+				],
+			},
+			staged: { type: 'boolean' },
+			insertions: { type: 'integer' },
+			deletions: { type: 'integer' },
+			oldPath: { type: 'string' },
+			conflictType: {
+				type: 'string',
+				enum: [
+					'both-modified',
+					'deleted-by-us',
+					'deleted-by-them',
+					'both-added',
+					'both-deleted',
+				],
+			},
+		},
+		required: ['path', 'status', 'staged'],
+	},
+	GitDiff: {
+		type: 'object',
+		properties: {
+			file: { type: 'string' },
+			diff: { type: 'string' },
+			insertions: { type: 'integer' },
+			deletions: { type: 'integer' },
+			language: { type: 'string' },
+			binary: { type: 'boolean' },
+		},
+		required: ['file', 'diff', 'insertions', 'deletions', 'language', 'binary'],
+	},
+	GitBranch: {
+		type: 'object',
+		properties: {
+			current: { type: 'string' },
+			upstream: { type: 'string' },
+			ahead: { type: 'integer' },
+			behind: { type: 'integer' },
+			all: {
+				type: 'array',
+				items: { type: 'string' },
+			},
+		},
+		required: ['current', 'upstream', 'ahead', 'behind', 'all'],
+	},
+	GitCommit: {
+		type: 'object',
+		properties: {
+			hash: { type: 'string' },
+			message: { type: 'string' },
+			filesChanged: { type: 'integer' },
+			insertions: { type: 'integer' },
+			deletions: { type: 'integer' },
+		},
+		required: ['hash', 'message', 'filesChanged', 'insertions', 'deletions'],
+	},
+	Terminal: {
+		type: 'object',
+		properties: {
+			id: { type: 'string' },
+			pid: { type: 'integer' },
+			command: { type: 'string' },
+			args: {
+				type: 'array',
+				items: { type: 'string' },
+			},
+			cwd: { type: 'string' },
+			purpose: { type: 'string' },
+			createdBy: {
+				type: 'string',
+				enum: ['user', 'llm'],
+			},
+			title: { type: 'string' },
+			status: {
+				type: 'string',
+				enum: ['running', 'exited'],
+			},
+			exitCode: { type: 'integer' },
+			createdAt: { type: 'string', format: 'date-time' },
+			uptime: { type: 'integer' },
+		},
+	},
+} as const;

package/src/openapi/spec.ts

@@ -0,0 +1,49 @@
+import { askPaths } from './paths/ask';
+import { configPaths } from './paths/config';
+import { filesPaths } from './paths/files';
+import { gitPaths } from './paths/git';
+import { messagesPaths } from './paths/messages';
+import { sessionsPaths } from './paths/sessions';
+import { streamPaths } from './paths/stream';
+import { schemas } from './schemas';
+
+import { terminalsPath } from './paths/terminals';
+import { setuPaths } from './paths/setu';
+
+export function getOpenAPISpec() {
+	const spec = {
+		openapi: '3.0.3',
+		info: {
+			title: 'otto server API',
+			version: '0.1.0',
+			description:
+				'Server-side API for otto sessions, messages, and streaming events. All AI work runs on the server. Streaming uses SSE.',
+		},
+		tags: [
+			{ name: 'sessions' },
+			{ name: 'messages' },
+			{ name: 'stream' },
+			{ name: 'ask' },
+			{ name: 'config' },
+			{ name: 'files' },
+			{ name: 'git' },
+			{ name: 'terminals' },
+			{ name: 'setu' },
+		],
+		paths: {
+			...askPaths,
+			...sessionsPaths,
+			...messagesPaths,
+			...streamPaths,
+			...configPaths,
+			...filesPaths,
+			...gitPaths,
+			...terminalsPath,
+			...setuPaths,
+		},
+		components: {
+			schemas,
+		},
+	} as const;
+	return spec;
+}

package/src/presets.ts

@@ -0,0 +1,85 @@
+import AGENT_BUILD from '@ottocode/sdk/prompts/agents/build.txt' with {
+	type: 'text',
+};
+import AGENT_PLAN from '@ottocode/sdk/prompts/agents/plan.txt' with {
+	type: 'text',
+};
+import AGENT_GENERAL from '@ottocode/sdk/prompts/agents/general.txt' with {
+	type: 'text',
+};
+
+export const BUILTIN_AGENTS = {
+	build: {
+		prompt: AGENT_BUILD,
+		tools: [
+			'read',
+			'write',
+			'ls',
+			'tree',
+			'bash',
+			'update_todos',
+			'grep',
+			'terminal',
+			'git_status',
+			'git_diff',
+			'ripgrep',
+			'apply_patch',
+			'websearch',
+			'progress_update',
+			'finish',
+		] as string[],
+	},
+	plan: {
+		prompt: AGENT_PLAN,
+		tools: [
+			'read',
+			'ls',
+			'tree',
+			'ripgrep',
+			'update_todos',
+			'websearch',
+			'progress_update',
+			'finish',
+		] as string[],
+	},
+	general: {
+		prompt: AGENT_GENERAL,
+		tools: [
+			'read',
+			'write',
+			'ls',
+			'tree',
+			'bash',
+			'ripgrep',
+			'terminal',
+			'websearch',
+			'update_todos',
+			'progress_update',
+			'finish',
+		] as string[],
+	},
+};
+
+export const BUILTIN_TOOLS = [
+	'read',
+	'write',
+	'ls',
+	'tree',
+	'bash',
+	'terminal',
+	'grep',
+	'ripgrep',
+	'git_status',
+	'git_diff',
+	'git_commit',
+	'apply_patch',
+	'update_todos',
+	'edit',
+	'websearch',
+	'progress_update',
+	'finish',
+	'skill',
+] as const;
+
+export type BuiltinAgent = keyof typeof BUILTIN_AGENTS;
+export type BuiltinTool = (typeof BUILTIN_TOOLS)[number];

package/src/routes/ask.ts

@@ -0,0 +1,113 @@
+import type { Hono } from 'hono';
+import type {
+	AskServerRequest,
+	InjectableConfig,
+	InjectableCredentials,
+} from '../runtime/ask/service.ts';
+import { handleAskRequest } from '../runtime/ask/service.ts';
+import { serializeError } from '../runtime/errors/api-error.ts';
+import { logger } from '@ottocode/sdk';
+import type { EmbeddedAppConfig } from '../index.ts';
+
+export function registerAskRoutes(app: Hono) {
+	app.post('/v1/ask', async (c) => {
+		const projectRoot = c.req.query('project') || process.cwd();
+		const body = (await c.req.json().catch(() => ({}))) as Record<
+			string,
+			unknown
+		>;
+		const prompt = typeof body.prompt === 'string' ? body.prompt : '';
+		if (!prompt.trim().length) {
+			return c.json({ error: 'Prompt is required.' }, 400);
+		}
+
+		const embeddedConfig = c.get('embeddedConfig') as
+			| EmbeddedAppConfig
+			| undefined;
+
+		// Hybrid fallback: Use embedded config if provided, otherwise fall back to files/env
+		let injectableConfig: InjectableConfig | undefined;
+		let injectableCredentials: InjectableCredentials | undefined;
+		let skipFileConfig = false;
+
+		if (embeddedConfig && Object.keys(embeddedConfig).length > 0) {
+			// Has embedded config - build injectable config from it
+			const defaults = embeddedConfig.defaults;
+			const hasDefaults =
+				defaults ||
+				embeddedConfig.provider ||
+				embeddedConfig.model ||
+				embeddedConfig.agent;
+
+			if (hasDefaults) {
+				injectableConfig = {
+					provider: defaults?.provider ?? embeddedConfig.provider,
+					model: defaults?.model ?? embeddedConfig.model,
+					agent: defaults?.agent ?? embeddedConfig.agent,
+				};
+			}
+
+			// Convert embedded auth to injectable credentials
+			const hasAuth = embeddedConfig.auth || embeddedConfig.apiKey;
+			if (hasAuth) {
+				if (embeddedConfig.auth) {
+					injectableCredentials = {} as InjectableCredentials;
+					for (const [provider, auth] of Object.entries(embeddedConfig.auth)) {
+						if ('apiKey' in auth) {
+							(injectableCredentials as Record<string, { apiKey: string }>)[
+								provider
+							] = { apiKey: auth.apiKey };
+						}
+					}
+				} else if (embeddedConfig.apiKey && embeddedConfig.provider) {
+					injectableCredentials = {
+						[embeddedConfig.provider]: { apiKey: embeddedConfig.apiKey },
+					};
+				}
+
+				// Only skip file config if we have credentials injected
+				skipFileConfig = true;
+			}
+			// If no auth provided, skipFileConfig stays false -> will use ensureProviderEnv -> auth.json fallback
+		}
+
+		const request: AskServerRequest = {
+			projectRoot,
+			prompt,
+			agent: typeof body.agent === 'string' ? body.agent : undefined,
+			provider: typeof body.provider === 'string' ? body.provider : undefined,
+			model: typeof body.model === 'string' ? body.model : undefined,
+			sessionId:
+				typeof body.sessionId === 'string' ? body.sessionId : undefined,
+			last: Boolean(body.last),
+			jsonMode: Boolean(body.jsonMode),
+			skipFileConfig:
+				skipFileConfig ||
+				(typeof body.skipFileConfig === 'boolean'
+					? body.skipFileConfig
+					: false),
+			config:
+				injectableConfig ||
+				(body.config && typeof body.config === 'object'
+					? (body.config as InjectableConfig)
+					: undefined),
+			credentials:
+				injectableCredentials ||
+				(body.credentials && typeof body.credentials === 'object'
+					? (body.credentials as InjectableCredentials)
+					: undefined),
+			agentPrompt:
+				typeof body.agentPrompt === 'string' ? body.agentPrompt : undefined,
+			tools: Array.isArray(body.tools) ? body.tools : undefined,
+		};
+
+		try {
+			const response = await handleAskRequest(request);
+			return c.json(response, 202);
+		} catch (err) {
+			logger.error('Ask request failed', err);
+			const errorResponse = serializeError(err);
+			return c.json(errorResponse, errorResponse.error.status || 400);
+		}
+	});
+}