@agi-cli/server 0.1.79 → 0.1.81

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@agi-cli/server",
-	"version": "0.1.79",
+	"version": "0.1.81",
 	"description": "HTTP API server for AGI CLI",
 	"type": "module",
 	"main": "./src/index.ts",
@@ -29,8 +29,8 @@
 		"typecheck": "tsc --noEmit"
 	},
 	"dependencies": {
-		"@agi-cli/sdk": "0.1.79",
-		"@agi-cli/database": "0.1.79",
+		"@agi-cli/sdk": "0.1.81",
+		"@agi-cli/database": "0.1.81",
 		"drizzle-orm": "^0.44.5",
 		"hono": "^4.9.9",
 		"zod": "^4.1.8"

package/src/index.ts

@@ -8,6 +8,7 @@ import { registerSessionMessagesRoutes } from './routes/session-messages.ts';
 import { registerSessionStreamRoute } from './routes/session-stream.ts';
 import { registerAskRoutes } from './routes/ask.ts';
 import { registerConfigRoutes } from './routes/config.ts';
+import { registerFilesRoutes } from './routes/files.ts';
 import { registerGitRoutes } from './routes/git.ts';
 import type { AgentConfigEntry } from './runtime/agent-registry.ts';
 
@@ -52,6 +53,7 @@ function initApp() {
 	registerSessionStreamRoute(app);
 	registerAskRoutes(app);
 	registerConfigRoutes(app);
+	registerFilesRoutes(app);
 	registerGitRoutes(app);
 
 	return app;
@@ -115,6 +117,7 @@ export function createStandaloneApp(_config?: StandaloneAppConfig) {
 	registerSessionStreamRoute(honoApp);
 	registerAskRoutes(honoApp);
 	registerConfigRoutes(honoApp);
+	registerFilesRoutes(honoApp);
 	registerGitRoutes(honoApp);
 
 	return honoApp;
@@ -206,6 +209,7 @@ export function createEmbeddedApp(config: EmbeddedAppConfig = {}) {
 	registerSessionStreamRoute(honoApp);
 	registerAskRoutes(honoApp);
 	registerConfigRoutes(honoApp);
+	registerFilesRoutes(honoApp);
 	registerGitRoutes(honoApp);
 
 	return honoApp;

package/src/openapi/helpers.ts

@@ -0,0 +1,64 @@
+export function projectQueryParam() {
+	return {
+		in: 'query',
+		name: 'project',
+		required: false,
+		schema: { type: 'string' },
+		description:
+			'Project root override (defaults to current working directory).',
+	} as const;
+}
+
+export function sessionIdParam() {
+	return {
+		in: 'path',
+		name: 'id',
+		required: true,
+		schema: { type: 'string' },
+	} as const;
+}
+
+export function withoutParam() {
+	return {
+		in: 'query',
+		name: 'without',
+		required: false,
+		schema: { type: 'string', enum: ['parts'] },
+		description:
+			'Exclude parts from the response. By default, parts are included.',
+	} as const;
+}
+
+export function errorResponse() {
+	return {
+		description: 'Bad Request',
+		content: {
+			'application/json': {
+				schema: {
+					type: 'object',
+					properties: { error: { type: 'string' } },
+					required: ['error'],
+				},
+			},
+		},
+	} as const;
+}
+
+export function gitErrorResponse() {
+	return {
+		description: 'Error',
+		content: {
+			'application/json': {
+				schema: {
+					type: 'object',
+					properties: {
+						status: { type: 'string', enum: ['error'] },
+						error: { type: 'string' },
+						code: { type: 'string' },
+					},
+					required: ['status', 'error'],
+				},
+			},
+		},
+	} as const;
+}

package/src/openapi/paths/ask.ts

@@ -0,0 +1,70 @@
+import { errorResponse, projectQueryParam } from '../helpers';
+
+export const askPaths = {
+	'/v1/ask': {
+		post: {
+			tags: ['ask'],
+			operationId: 'ask',
+			summary: 'Send a prompt using the ask service',
+			description:
+				'Streamlined endpoint used by the CLI to send prompts and receive assistant responses. Creates sessions as needed and reuses the last session when requested.',
+			parameters: [projectQueryParam()],
+			requestBody: {
+				required: true,
+				content: {
+					'application/json': {
+						schema: {
+							type: 'object',
+							required: ['prompt'],
+							properties: {
+								prompt: {
+									type: 'string',
+									description: 'User prompt to send to the assistant.',
+								},
+								agent: {
+									type: 'string',
+									description: 'Optional agent name to use for this request.',
+								},
+								provider: {
+									$ref: '#/components/schemas/Provider',
+									description:
+										'Optional provider override. When omitted the agent and config defaults apply.',
+								},
+								model: {
+									type: 'string',
+									description:
+										'Optional model override for the selected provider.',
+								},
+								sessionId: {
+									type: 'string',
+									description: 'Send the prompt to a specific session.',
+								},
+								last: {
+									type: 'boolean',
+									description:
+										'If true, reuse the most recent session for the project.',
+								},
+								jsonMode: {
+									type: 'boolean',
+									description:
+										'Request structured JSON output when supported by the agent.',
+								},
+							},
+						},
+					},
+				},
+			},
+			responses: {
+				202: {
+					description: 'Accepted',
+					content: {
+						'application/json': {
+							schema: { $ref: '#/components/schemas/AskResponse' },
+						},
+					},
+				},
+				400: errorResponse(),
+			},
+		},
+	},
+} as const;

package/src/openapi/paths/config.ts

@@ -0,0 +1,164 @@
+import { projectQueryParam } from '../helpers';
+
+export const configPaths = {
+	'/v1/config': {
+		get: {
+			tags: ['config'],
+			operationId: 'getConfig',
+			summary: 'Get full configuration',
+			description: 'Returns agents, authorized providers, models, and defaults',
+			parameters: [projectQueryParam()],
+			responses: {
+				200: {
+					description: 'OK',
+					content: {
+						'application/json': {
+							schema: { $ref: '#/components/schemas/Config' },
+						},
+					},
+				},
+			},
+		},
+	},
+	'/v1/config/cwd': {
+		get: {
+			tags: ['config'],
+			operationId: 'getCwd',
+			summary: 'Get current working directory info',
+			responses: {
+				200: {
+					description: 'OK',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: {
+									cwd: { type: 'string' },
+									dirName: { type: 'string' },
+								},
+								required: ['cwd', 'dirName'],
+							},
+						},
+					},
+				},
+			},
+		},
+	},
+	'/v1/config/agents': {
+		get: {
+			tags: ['config'],
+			operationId: 'getAgents',
+			summary: 'Get available agents',
+			parameters: [projectQueryParam()],
+			responses: {
+				200: {
+					description: 'OK',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: {
+									agents: {
+										type: 'array',
+										items: { type: 'string' },
+									},
+									default: { type: 'string' },
+								},
+								required: ['agents', 'default'],
+							},
+						},
+					},
+				},
+			},
+		},
+	},
+	'/v1/config/providers': {
+		get: {
+			tags: ['config'],
+			operationId: 'getProviders',
+			summary: 'Get available providers',
+			description: 'Returns only providers that have been authorized',
+			parameters: [projectQueryParam()],
+			responses: {
+				200: {
+					description: 'OK',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: {
+									providers: {
+										type: 'array',
+										items: { $ref: '#/components/schemas/Provider' },
+									},
+									default: { $ref: '#/components/schemas/Provider' },
+								},
+								required: ['providers', 'default'],
+							},
+						},
+					},
+				},
+			},
+		},
+	},
+	'/v1/config/providers/{provider}/models': {
+		get: {
+			tags: ['config'],
+			operationId: 'getProviderModels',
+			summary: 'Get available models for a provider',
+			parameters: [
+				projectQueryParam(),
+				{
+					in: 'path',
+					name: 'provider',
+					required: true,
+					schema: { $ref: '#/components/schemas/Provider' },
+				},
+			],
+			responses: {
+				200: {
+					description: 'OK',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: {
+									models: {
+										type: 'array',
+										items: { $ref: '#/components/schemas/Model' },
+									},
+									default: { type: 'string', nullable: true },
+								},
+								required: ['models'],
+							},
+						},
+					},
+				},
+				403: {
+					description: 'Provider not authorized',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: { error: { type: 'string' } },
+								required: ['error'],
+							},
+						},
+					},
+				},
+				404: {
+					description: 'Provider not found',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: { error: { type: 'string' } },
+								required: ['error'],
+							},
+						},
+					},
+				},
+			},
+		},
+	},
+} as const;

package/src/openapi/paths/files.ts

@@ -0,0 +1,72 @@
+import { projectQueryParam } from '../helpers';
+
+export const filesPaths = {
+	'/v1/files': {
+		get: {
+			tags: ['files'],
+			operationId: 'listFiles',
+			summary: 'List project files',
+			description:
+				'Returns list of files in the project directory, excluding common build artifacts and dependencies',
+			parameters: [
+				projectQueryParam(),
+				{
+					in: 'query',
+					name: 'maxDepth',
+					required: false,
+					schema: { type: 'integer', default: 10 },
+					description: 'Maximum directory depth to traverse',
+				},
+				{
+					in: 'query',
+					name: 'limit',
+					required: false,
+					schema: { type: 'integer', default: 1000 },
+					description: 'Maximum number of files to return',
+				},
+			],
+			responses: {
+				200: {
+					description: 'OK',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: {
+									files: {
+										type: 'array',
+										items: { type: 'string' },
+									},
+									changedFiles: {
+										type: 'array',
+										items: {
+											type: 'object',
+											properties: {
+												path: { type: 'string' },
+												status: {
+													type: 'string',
+													enum: [
+														'added',
+														'modified',
+														'deleted',
+														'renamed',
+														'untracked',
+													],
+												},
+											},
+											required: ['path', 'status'],
+										},
+										description:
+											'List of files with uncommitted changes (from git status)',
+									},
+									truncated: { type: 'boolean' },
+								},
+								required: ['files', 'changedFiles', 'truncated'],
+							},
+						},
+					},
+				},
+			},
+		},
+	},
+} as const;