cyrusagents
diff --git a/‎CHANGELOG.internal.md‎
Lines changed: 3 additions & 0 deletions b/‎CHANGELOG.internal.md‎
Lines changed: 3 additions & 0 deletions
diff --git a/‎CHANGELOG.md‎
Lines changed: 1 addition & 0 deletions b/‎CHANGELOG.md‎
Lines changed: 1 addition & 0 deletions
diff --git a/‎package.json‎
Lines changed: 2 additions & 1 deletion b/‎package.json‎
Lines changed: 2 additions & 1 deletion
diff --git a/‎packages/claude-runner/package.json‎
Lines changed: 1 addition & 1 deletion b/‎packages/claude-runner/package.json‎
Lines changed: 1 addition & 1 deletion
diff --git a/‎packages/codex-runner/package.json‎
Lines changed: 2 additions & 1 deletion b/‎packages/codex-runner/package.json‎
Lines changed: 2 additions & 1 deletion
diff --git a/‎packages/codex-runner/src/SimpleCodexRunner.ts‎
Lines changed: 182 additions & 0 deletions b/‎packages/codex-runner/src/SimpleCodexRunner.ts‎
Lines changed: 182 additions & 0 deletions
diff --git a/‎packages/codex-runner/src/index.ts‎
Lines changed: 1 addition & 0 deletions b/‎packages/codex-runner/src/index.ts‎
Lines changed: 1 addition & 0 deletions
diff --git a/‎packages/core/src/config-schemas.ts‎
Lines changed: 7 additions & 0 deletions b/‎packages/core/src/config-schemas.ts‎
Lines changed: 7 additions & 0 deletions
diff --git a/‎packages/cursor-runner/package.json‎
Lines changed: 2 additions & 1 deletion b/‎packages/cursor-runner/package.json‎
Lines changed: 2 additions & 1 deletion
@@ -4,6 +4,9 @@ This changelog documents internal development changes, refactors, tooling update
 
 ## [Unreleased]
 
+### Added
+- Added `SimpleCodexRunner` and `SimpleCursorRunner` implementations for constrained-response queries (ProcedureAnalyzer classification). Both follow the same `SimpleAgentRunner<T>` abstract pattern as Claude and Gemini. Added `defaultRunner` field to `EdgeConfigSchema` (flows through to config update endpoint automatically). `RunnerSelectionService.getDefaultRunner()` implements priority: explicit config > single-API-key auto-detect > "claude" fallback. `ProcedureAnalyzer` now supports all 4 runner types with runner-specific default models. Pinned zod to 4.3.6 via pnpm overrides to eliminate dual-version type incompatibility that blocked cross-package type resolution. Deleted obsolete `codex-runner-shim.d.ts`. Changed `SDKMessage` imports in `simple-agent-runner` from `@anthropic-ai/claude-agent-sdk` to `cyrus-core` to avoid cross-package type conflicts. ([CYPACK-826](https://linear.app/ceedar/issue/CYPACK-826), [#878](https://github.com/ceedaragents/cyrus/pull/878))
+
 ### Changed
 - `SlackEventTransport.getSlackBotToken()` now reads `SLACK_BOT_TOKEN` exclusively from `process.env` with no header fallback. The `X-Slack-Bot-Token` request header is no longer used. ([CYPACK-824](https://linear.app/ceedar/issue/CYPACK-824), [#876](https://github.com/ceedaragents/cyrus/pull/876))
 - Refactored `EdgeWorker.ts` by extracting 5 service modules: `ActivityPoster` (Linear activity posting), `AttachmentService` (attachment download/manifests), `ConfigManager` (config file watching/reload/change detection), `PromptBuilder` (prompt assembly/system prompts/issue context), and `RunnerSelectionService` (runner/model selection/tool configuration). Reduced EdgeWorker from 7,687 to 5,466 lines (29% reduction) while maintaining full test coverage (522 tests). ([CYPACK-822](https://linear.app/ceedar/issue/CYPACK-822), [#874](https://github.com/ceedaragents/cyrus/pull/874))
 
@@ -5,6 +5,7 @@ All notable changes to this project will be documented in this file.
 ## [Unreleased]
 
 ### Added
+- **Configurable default runner** - The default agent harness is now configurable via `defaultRunner` in `config.json` (values: `"claude"`, `"gemini"`, `"codex"`, `"cursor"`) instead of always defaulting to Claude. When only one API key is set (Claude, Gemini, Codex, or Cursor), that runner is auto-detected as the default. When multiple keys are present, set `defaultRunner` to choose which one is used for new sessions. The setting is also updateable via the config update endpoint. ([CYPACK-826](https://linear.app/ceedar/issue/CYPACK-826), [#878](https://github.com/ceedaragents/cyrus/pull/878))
 - GitHub PR comment support: Cyrus can now be triggered by `@cyrusagent` mentions on GitHub pull request comments, creating sessions and posting replies directly on PRs. ([CYPACK-772](https://linear.app/ceedar/issue/CYPACK-772), [#820](https://github.com/ceedaragents/cyrus/pull/820))
 - Slack integration: Cyrus can now receive `@mention` webhooks from Slack channels and threads, enabling Slack as a new platform for triggering agent sessions. ([CYPACK-807](https://linear.app/ceedar/issue/CYPACK-807), [#861](https://github.com/ceedaragents/cyrus/pull/861))
 
 
@@ -48,7 +48,8 @@
 			"@modelcontextprotocol/sdk": ">=1.25.2",
 			"semver": ">=7.5.2",
 			"qs": ">=6.14.1",
-			"vite": ">=7.1.11"
+			"vite": ">=7.1.11",
+			"zod": "4.3.6"
 		}
 	},
 	"lint-staged": {
 
@@ -23,7 +23,7 @@
 		"dotenv": "^16.4.5",
 		"fs-extra": "^11.3.2",
 		"openai": "^6.9.1",
-		"zod": "^4.3.5"
+		"zod": "^4.3.6"
 	},
 	"devDependencies": {
 		"@types/fs-extra": "^11.0.4",
 
@@ -17,7 +17,8 @@
 	},
 	"dependencies": {
 		"@openai/codex-sdk": "^0.98.0",
-		"cyrus-core": "workspace:*"
+		"cyrus-core": "workspace:*",
+		"cyrus-simple-agent-runner": "workspace:*"
 	},
 	"devDependencies": {
 		"@types/node": "^20.0.0",
 
@@ -0,0 +1,182 @@
+import type { SDKMessage } from "cyrus-core";
+import {
+	NoResponseError,
+	SessionError,
+	type SimpleAgentQueryOptions,
+	SimpleAgentRunner,
+} from "cyrus-simple-agent-runner";
+import { CodexRunner } from "./CodexRunner.js";
+
+/**
+ * Concrete implementation using CodexRunner from cyrus-codex-runner package.
+ *
+ * This implementation uses the Codex SDK to execute queries and
+ * constrains the responses to an enumerated set.
+ */
+export class SimpleCodexRunner<T extends string> extends SimpleAgentRunner<T> {
+	/**
+	 * Execute the agent using CodexRunner
+	 */
+	protected async executeAgent(
+		prompt: string,
+		options?: SimpleAgentQueryOptions,
+	): Promise<SDKMessage[]> {
+		const messages: SDKMessage[] = [];
+		let sessionError: Error | null = null;
+
+		// Build the full prompt with context if provided
+		const fullPrompt = options?.context
+			? `${options.context}\n\n${prompt}`
+			: prompt;
+
+		// Create CodexRunner with configuration
+		const runner = new CodexRunner({
+			workingDirectory: this.config.workingDirectory,
+			cyrusHome: this.config.cyrusHome,
+			model: this.config.model,
+			fallbackModel: this.config.fallbackModel,
+			maxTurns: this.config.maxTurns,
+			appendSystemPrompt: this.buildSystemPrompt(),
+			// Limit tools for simple queries
+			disallowedTools: options?.allowFileReading
+				? []
+				: ["Read", "Edit", "Write", "Bash", "Glob", "Grep"],
+			allowedDirectories: options?.allowedDirectories,
+		});
+
+		// Set up event handlers
+		runner.on("message", (message) => {
+			messages.push(message);
+			this.handleMessage(message);
+		});
+
+		runner.on("error", (error) => {
+			sessionError = error;
+		});
+
+		runner.on("complete", () => {
+			this.emitProgress({ type: "validating", response: "complete" });
+		});
+
+		try {
+			this.emitProgress({ type: "started", sessionId: null });
+			await runner.start(fullPrompt);
+
+			// Update session ID in progress events
+			const sessionId = messages[0]?.session_id || null;
+			if (sessionId) {
+				this.emitProgress({ type: "started", sessionId });
+			}
+
+			if (sessionError) {
+				throw new SessionError(sessionError, messages);
+			}
+
+			return messages;
+		} catch (error) {
+			if (error instanceof Error) {
+				throw error;
+			}
+			throw new SessionError(new Error(String(error)), messages);
+		}
+	}
+
+	/**
+	 * Extract the final response from the last assistant message
+	 */
+	protected extractResponse(messages: SDKMessage[]): string {
+		// Find the last assistant message with text content
+		for (let i = messages.length - 1; i >= 0; i--) {
+			const message = messages[i];
+			if (!message) continue;
+
+			if (
+				message.type === "assistant" &&
+				"message" in message &&
+				message.message &&
+				message.message.content
+			) {
+				// Extract text from content blocks
+				for (const block of message.message.content) {
+					if (
+						typeof block === "object" &&
+						block !== null &&
+						"type" in block &&
+						block.type === "text" &&
+						"text" in block
+					) {
+						// Clean the response (remove whitespace, markdown, etc.)
+						const cleaned = this.cleanResponse(block.text as string);
+						if (cleaned) {
+							this.emitProgress({
+								type: "response-detected",
+								candidateResponse: cleaned,
+							});
+							return cleaned;
+						}
+					}
+				}
+			}
+		}
+
+		throw new NoResponseError(messages);
+	}
+
+	/**
+	 * Clean the response text to extract the actual value
+	 */
+	private cleanResponse(text: string): string {
+		// Remove markdown code blocks
+		let cleaned = text.replace(/```[\s\S]*?```/g, "");
+
+		// Remove inline code
+		cleaned = cleaned.replace(/`([^`]+)`/g, "$1");
+
+		// Remove quotes
+		cleaned = cleaned.replace(/^["']|["']$/g, "");
+
+		// Trim whitespace
+		cleaned = cleaned.trim();
+
+		// If the response is multi-line, try to find a valid response on any line
+		const lines = cleaned.split("\n").map((l) => l.trim());
+		for (const line of lines) {
+			if (this.isValidResponse(line)) {
+				return line;
+			}
+		}
+
+		// Return the cleaned text (will be validated by caller)
+		return cleaned;
+	}
+
+	/**
+	 * Handle incoming messages for progress events
+	 */
+	private handleMessage(message: SDKMessage): void {
+		if (
+			message.type === "assistant" &&
+			"message" in message &&
+			message.message &&
+			message.message.content
+		) {
+			for (const block of message.message.content) {
+				if (typeof block === "object" && block !== null && "type" in block) {
+					if (block.type === "text" && "text" in block) {
+						this.emitProgress({ type: "thinking", text: block.text as string });
+					} else if (
+						block.type === "tool_use" &&
+						"name" in block &&
+						"input" in block
+					) {
+						this.emitProgress({
+							type: "tool-use",
+							toolName: block.name as string,
+							input: block.input,
+						});
+					}
+				}
+			}
+		}
+	}
+}
@@ -1,4 +1,5 @@
 export { CodexRunner } from "./CodexRunner.js";
+export { SimpleCodexRunner } from "./SimpleCodexRunner.js";
 export type {
 	CodexJsonEvent,
 	CodexRunnerConfig,
 
@@ -196,6 +196,13 @@ export const EdgeConfigSchema = z.object({
 	/** Default Codex model to use across all repositories (e.g., "gpt-5.3-codex", "gpt-5.2-codex") */
 	codexDefaultModel: z.string().optional(),
 
+	/**
+	 * Default runner/harness to use when no runner is specified via labels or description tags.
+	 * If omitted, auto-detected from available API keys (if exactly one is configured),
+	 * otherwise falls back to "claude".
+	 */
+	defaultRunner: z.enum(["claude", "gemini", "codex", "cursor"]).optional(),
+
 	/**
 	 * @deprecated Use claudeDefaultModel instead.
 	 * Legacy field retained for backwards compatibility and migrated on load.
 
@@ -16,7 +16,8 @@
 		"typecheck": "tsc --noEmit"
 	},
 	"dependencies": {
-		"cyrus-core": "workspace:*"
+		"cyrus-core": "workspace:*",
+		"cyrus-simple-agent-runner": "workspace:*"
 	},
 	"devDependencies": {
 		"@types/node": "^20.0.0",
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,5 @@`
`1`	`1`	`export { CodexRunner } from "./CodexRunner.js";`
	`2`	`+export { SimpleCodexRunner } from "./SimpleCodexRunner.js";`
`2`	`3`	`export type {`
`3`	`4`	`CodexJsonEvent,`
`4`	`5`	`CodexRunnerConfig,`