@ottocode/server 0.1.190 → 0.1.192

package/package.json

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

package/src/routes/config/defaults.ts

@@ -12,6 +12,7 @@ export function registerDefaultsRoute(app: Hono) {
 				provider?: string;
 				model?: string;
 				toolApproval?: 'auto' | 'dangerous' | 'all';
+				guidedMode?: boolean;
 				scope?: 'global' | 'local';
 			}>();
 
@@ -21,12 +22,14 @@ export function registerDefaultsRoute(app: Hono) {
 				provider: string;
 				model: string;
 				toolApproval: 'auto' | 'dangerous' | 'all';
+				guidedMode: boolean;
 			}> = {};
 
 			if (body.agent) updates.agent = body.agent;
 			if (body.provider) updates.provider = body.provider;
 			if (body.model) updates.model = body.model;
 			if (body.toolApproval) updates.toolApproval = body.toolApproval;
+			if (body.guidedMode !== undefined) updates.guidedMode = body.guidedMode;
 
 			await setConfig(scope, updates, projectRoot);
 

package/src/routes/config/main.ts

@@ -57,6 +57,7 @@ export function registerMainConfigRoute(app: Hono) {
 					embeddedConfig?.defaults?.toolApproval,
 					cfg.defaults.toolApproval,
 				) as 'auto' | 'dangerous' | 'all',
+				guidedMode: cfg.defaults.guidedMode ?? false,
 			};
 
 			return c.json({

package/src/runtime/agent/runner-setup.ts

@@ -105,6 +105,7 @@ export async function setupRunner(opts: RunOpts): Promise<SetupResult> {
 		projectRoot: cfg.projectRoot,
 		agentPrompt,
 		oneShot: opts.oneShot,
+		guidedMode: cfg.defaults.guidedMode,
 		spoofPrompt: undefined,
 		includeProjectTree: isFirstMessage,
 		userContext: opts.userContext,

package/src/runtime/context/environment.ts

@@ -121,12 +121,16 @@ export async function getProjectTree(projectRoot: string): Promise<string> {
 
 export async function findInstructionFiles(
 	projectRoot: string,
+	options?: { guidedMode?: boolean },
 ): Promise<string[]> {
 	const { existsSync } = await import('node:fs');
 	const { join } = await import('node:path');
 	const foundPaths: string[] = [];
 
 	const localFiles = ['AGENTS.md', 'CLAUDE.md', 'CONTEXT.md'];
+	if (options?.guidedMode) {
+		localFiles.push('GUIDED.md');
+	}
 	for (const filename of localFiles) {
 		let currentDir = projectRoot;
 		for (let i = 0; i < 5; i++) {
@@ -158,8 +162,9 @@ export async function findInstructionFiles(
 
 export async function loadInstructionFiles(
 	projectRoot: string,
+	options?: { guidedMode?: boolean },
 ): Promise<string> {
-	const paths = await findInstructionFiles(projectRoot);
+	const paths = await findInstructionFiles(projectRoot, options);
 	if (paths.length === 0) return '';
 
 	const contents: string[] = [];
@@ -181,7 +186,7 @@ export async function loadInstructionFiles(
 
 export async function composeEnvironmentAndInstructions(
 	projectRoot: string,
-	options?: { includeProjectTree?: boolean },
+	options?: { includeProjectTree?: boolean; guidedMode?: boolean },
 ): Promise<string> {
 	const parts: string[] = [];
 
@@ -195,7 +200,9 @@ export async function composeEnvironmentAndInstructions(
 		}
 	}
 
-	const customInstructions = await loadInstructionFiles(projectRoot);
+	const customInstructions = await loadInstructionFiles(projectRoot, {
+		guidedMode: options?.guidedMode,
+	});
 	if (customInstructions) {
 		parts.push(customInstructions);
 	}

package/src/runtime/prompt/builder.ts

@@ -8,6 +8,10 @@ import ONESHOT_PROMPT from '@ottocode/sdk/prompts/modes/oneshot.txt' with {
 	type: 'text',
 };
 // eslint-disable-next-line @typescript-eslint/consistent-type-imports
+import GUIDED_PROMPT from '@ottocode/sdk/prompts/modes/guided.txt' with {
+	type: 'text',
+};
+// eslint-disable-next-line @typescript-eslint/consistent-type-imports
 import ANTHROPIC_SPOOF_PROMPT from '@ottocode/sdk/prompts/providers/anthropicSpoof.txt' with {
 	type: 'text',
 };
@@ -25,6 +29,7 @@ export async function composeSystemPrompt(options: {
 	projectRoot: string;
 	agentPrompt: string;
 	oneShot?: boolean;
+	guidedMode?: boolean;
 	spoofPrompt?: string;
 	includeEnvironment?: boolean;
 	includeProjectTree?: boolean;
@@ -79,10 +84,21 @@ export async function composeSystemPrompt(options: {
 		components.push('mode:oneshot');
 	}
 
+	if (options.guidedMode) {
+		const guidedBlock = (GUIDED_PROMPT || '').trim();
+		if (guidedBlock) {
+			parts.push(guidedBlock);
+			components.push('mode:guided');
+		}
+	}
+
 	if (options.includeEnvironment !== false) {
 		const envAndInstructions = await composeEnvironmentAndInstructions(
 			options.projectRoot,
-			{ includeProjectTree: options.includeProjectTree },
+			{
+				includeProjectTree: options.includeProjectTree,
+				guidedMode: options.guidedMode,
+			},
 		);
 		if (envAndInstructions) {
 			parts.push(envAndInstructions);