@agi-cli/server 0.1.131 → 0.1.133

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@agi-cli/server",
-	"version": "0.1.131",
+	"version": "0.1.133",
 	"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.131",
-		"@agi-cli/database": "0.1.131",
+		"@agi-cli/sdk": "0.1.133",
+		"@agi-cli/database": "0.1.133",
 		"drizzle-orm": "^0.44.5",
 		"hono": "^4.9.9",
 		"zod": "^4.1.8"

package/src/index.ts

@@ -16,6 +16,7 @@ import { registerTerminalsRoutes } from './routes/terminals.ts';
 import { registerSessionFilesRoutes } from './routes/session-files.ts';
 import { registerBranchRoutes } from './routes/branch.ts';
 import { registerResearchRoutes } from './routes/research.ts';
+import { registerSolforgeRoutes } from './routes/solforge.ts';
 import type { AgentConfigEntry } from './runtime/agent/registry.ts';
 
 const globalTerminalManager = new TerminalManager();
@@ -68,6 +69,7 @@ function initApp() {
 	registerSessionFilesRoutes(app);
 	registerBranchRoutes(app);
 	registerResearchRoutes(app);
+	registerSolforgeRoutes(app);
 
 	return app;
 }
@@ -136,6 +138,7 @@ export function createStandaloneApp(_config?: StandaloneAppConfig) {
 	registerSessionFilesRoutes(honoApp);
 	registerBranchRoutes(honoApp);
 	registerResearchRoutes(honoApp);
+	registerSolforgeRoutes(honoApp);
 
 	return honoApp;
 }
@@ -232,6 +235,7 @@ export function createEmbeddedApp(config: EmbeddedAppConfig = {}) {
 	registerSessionFilesRoutes(honoApp);
 	registerBranchRoutes(honoApp);
 	registerResearchRoutes(honoApp);
+	registerSolforgeRoutes(honoApp);
 
 	return honoApp;
 }

package/src/openapi/paths/config.ts

@@ -161,4 +161,58 @@ export const configPaths = {
 			},
 		},
 	},
+	'/v1/config/defaults': {
+		patch: {
+			tags: ['config'],
+			operationId: 'updateDefaults',
+			summary: 'Update default configuration',
+			description: 'Update the default agent, provider, and/or model',
+			parameters: [projectQueryParam()],
+			requestBody: {
+				required: true,
+				content: {
+					'application/json': {
+						schema: {
+							type: 'object',
+							properties: {
+								agent: { type: 'string' },
+								provider: { type: 'string' },
+								model: { type: 'string' },
+								scope: {
+									type: 'string',
+									enum: ['global', 'local'],
+									default: 'local',
+								},
+							},
+						},
+					},
+				},
+			},
+			responses: {
+				200: {
+					description: 'OK',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: {
+									success: { type: 'boolean' },
+									defaults: {
+										type: 'object',
+										properties: {
+											agent: { type: 'string' },
+											provider: { type: 'string' },
+											model: { type: 'string' },
+										},
+										required: ['agent', 'provider', 'model'],
+									},
+								},
+								required: ['success', 'defaults'],
+							},
+						},
+					},
+				},
+			},
+		},
+	},
 } as const;

package/src/openapi/paths/solforge.ts

@@ -0,0 +1,154 @@
+export const solforgePaths = {
+	'/v1/solforge/balance': {
+		get: {
+			tags: ['solforge'],
+			operationId: 'getSolforgeBalance',
+			summary: 'Get Solforge 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 Solforge',
+					content: {
+						'application/json': {
+							schema: {
+								type: 'object',
+								properties: { error: { type: 'string' } },
+								required: ['error'],
+							},
+						},
+					},
+				},
+			},
+		},
+	},
+	'/v1/solforge/wallet': {
+		get: {
+			tags: ['solforge'],
+			operationId: 'getSolforgeWallet',
+			summary: 'Get Solforge 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/solforge/usdc-balance': {
+		get: {
+			tags: ['solforge'],
+			operationId: 'getSolforgeUsdcBalance',
+			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/spec.ts

@@ -8,6 +8,7 @@ import { streamPaths } from './paths/stream';
 import { schemas } from './schemas';
 
 import { terminalsPath } from './paths/terminals';
+import { solforgePaths } from './paths/solforge';
 
 export function getOpenAPISpec() {
 	const spec = {
@@ -27,6 +28,7 @@ export function getOpenAPISpec() {
 			{ name: 'files' },
 			{ name: 'git' },
 			{ name: 'terminals' },
+			{ name: 'solforge' },
 		],
 		paths: {
 			...askPaths,
@@ -37,6 +39,7 @@ export function getOpenAPISpec() {
 			...filesPaths,
 			...gitPaths,
 			...terminalsPath,
+			...solforgePaths,
 		},
 		components: {
 			schemas,

package/src/routes/config/defaults.ts

@@ -0,0 +1,42 @@
+import type { Hono } from 'hono';
+import { setConfig, loadConfig } from '@agi-cli/sdk';
+import { logger } from '@agi-cli/sdk';
+import { serializeError } from '../../runtime/errors/api-error.ts';
+
+export function registerDefaultsRoute(app: Hono) {
+	app.patch('/v1/config/defaults', async (c) => {
+		try {
+			const projectRoot = c.req.query('project') || process.cwd();
+			const body = await c.req.json<{
+				agent?: string;
+				provider?: string;
+				model?: string;
+				scope?: 'global' | 'local';
+			}>();
+
+			const scope = body.scope || 'local';
+			const updates: Partial<{
+				agent: string;
+				provider: string;
+				model: string;
+			}> = {};
+
+			if (body.agent) updates.agent = body.agent;
+			if (body.provider) updates.provider = body.provider;
+			if (body.model) updates.model = body.model;
+
+			await setConfig(scope, updates, projectRoot);
+
+			const cfg = await loadConfig(projectRoot);
+
+			return c.json({
+				success: true,
+				defaults: cfg.defaults,
+			});
+		} catch (error) {
+			logger.error('Failed to update defaults', error);
+			const errorResponse = serializeError(error);
+			return c.json(errorResponse, errorResponse.error.status || 500);
+		}
+	});
+}

package/src/routes/config/index.ts

@@ -4,6 +4,7 @@ import { registerMainConfigRoute } from './main.ts';
 import { registerAgentsRoute } from './agents.ts';
 import { registerProvidersRoute } from './providers.ts';
 import { registerModelsRoutes } from './models.ts';
+import { registerDefaultsRoute } from './defaults.ts';
 
 export function registerConfigRoutes(app: Hono) {
 	registerCwdRoute(app);
@@ -11,4 +12,5 @@ export function registerConfigRoutes(app: Hono) {
 	registerAgentsRoute(app);
 	registerProvidersRoute(app);
 	registerModelsRoutes(app);
+	registerDefaultsRoute(app);
 }

package/src/routes/solforge.ts

@@ -0,0 +1,100 @@
+import type { Hono } from 'hono';
+import {
+	fetchSolforgeBalance,
+	getPublicKeyFromPrivate,
+	getAuth,
+	loadConfig,
+	fetchSolanaUsdcBalance,
+} from '@agi-cli/sdk';
+import { logger } from '@agi-cli/sdk';
+import { serializeError } from '../runtime/errors/api-error.ts';
+
+async function getSolforgePrivateKey(): Promise<string | null> {
+	if (process.env.SOLFORGE_PRIVATE_KEY) {
+		return process.env.SOLFORGE_PRIVATE_KEY;
+	}
+
+	try {
+		const cfg = await loadConfig(process.cwd());
+		const auth = await getAuth('solforge', cfg.projectRoot);
+		if (auth?.type === 'wallet' && auth.secret) {
+			return auth.secret;
+		}
+	} catch {}
+
+	return null;
+}
+
+export function registerSolforgeRoutes(app: Hono) {
+	app.get('/v1/solforge/balance', async (c) => {
+		try {
+			const privateKey = await getSolforgePrivateKey();
+			if (!privateKey) {
+				return c.json({ error: 'Solforge wallet not configured' }, 401);
+			}
+
+			const balance = await fetchSolforgeBalance({ privateKey });
+			if (!balance) {
+				return c.json({ error: 'Failed to fetch balance from Solforge' }, 502);
+			}
+
+			return c.json(balance);
+		} catch (error) {
+			logger.error('Failed to fetch Solforge balance', error);
+			const errorResponse = serializeError(error);
+			return c.json(errorResponse, errorResponse.error.status || 500);
+		}
+	});
+
+	app.get('/v1/solforge/wallet', async (c) => {
+		try {
+			const privateKey = await getSolforgePrivateKey();
+			if (!privateKey) {
+				return c.json(
+					{ error: 'Solforge wallet not configured', configured: false },
+					200,
+				);
+			}
+
+			const publicKey = getPublicKeyFromPrivate(privateKey);
+			if (!publicKey) {
+				return c.json({ error: 'Invalid private key', configured: false }, 200);
+			}
+
+			return c.json({
+				configured: true,
+				publicKey,
+			});
+		} catch (error) {
+			logger.error('Failed to get Solforge wallet info', error);
+			const errorResponse = serializeError(error);
+			return c.json(errorResponse, errorResponse.error.status || 500);
+		}
+	});
+
+	app.get('/v1/solforge/usdc-balance', async (c) => {
+		try {
+			const privateKey = await getSolforgePrivateKey();
+			if (!privateKey) {
+				return c.json({ error: 'Solforge wallet not configured' }, 401);
+			}
+
+			const network =
+				(c.req.query('network') as 'mainnet' | 'devnet') || 'mainnet';
+
+			const balance = await fetchSolanaUsdcBalance({ privateKey }, network);
+			if (!balance) {
+				return c.json(
+					{ error: 'Failed to fetch USDC balance from Solana' },
+					502,
+				);
+			}
+
+			return c.json(balance);
+		} catch (error) {
+			logger.error('Failed to fetch USDC balance', error);
+			const errorResponse = serializeError(error);
+			return c.json(errorResponse, errorResponse.error.status || 500);
+		}
+	});
+}

package/src/runtime/provider/openai.ts

@@ -5,7 +5,11 @@ import { openai, createOpenAI } from '@ai-sdk/openai';
 export async function resolveOpenAIModel(
 	model: string,
 	cfg: AGIConfig,
-	options?: { systemPrompt?: string },
+	options?: {
+		systemPrompt?: string;
+		promptCacheKey?: string;
+		promptCacheRetention?: 'in_memory' | '24h';
+	},
 ) {
 	const auth = await getAuth('openai', cfg.projectRoot);
 	if (auth?.type === 'oauth') {
@@ -16,6 +20,8 @@ export async function resolveOpenAIModel(
 			reasoningEffort: isCodexModel ? 'high' : 'medium',
 			reasoningSummary: 'auto',
 			instructions: options?.systemPrompt,
+			promptCacheKey: options?.promptCacheKey,
+			promptCacheRetention: options?.promptCacheRetention,
 		});
 	}
 	if (auth?.type === 'api' && auth.key) {

package/src/runtime/provider/solforge.ts

@@ -19,7 +19,6 @@ export function resolveSolforgeModel(model: string, sessionId?: string) {
 	}
 	const baseURL = process.env.SOLFORGE_BASE_URL;
 	const rpcURL = process.env.SOLFORGE_SOLANA_RPC_URL;
-	const topupAmount = process.env.SOLFORGE_TOPUP_MICRO_USDC;
 
 	const callbacks: SolforgePaymentCallbacks = sessionId
 		? {
@@ -62,7 +61,6 @@ export function resolveSolforgeModel(model: string, sessionId?: string) {
 		{
 			baseURL,
 			rpcURL,
-			topupAmountMicroUsdc: topupAmount,
 			callbacks,
 			providerNpm,
 		},