Refactor setup and tool helpers for improved modularity and clarity

- Moved setup logic into dedicated files: agent.ts, config.ts, index.ts, workspace.ts.
- Introduced tool-helpers.ts for shared functions across tools, reducing boilerplate.
- Updated tools (status, task-comment, task-create, task-update, work-finish, work-start) to utilize new helper functions for workspace resolution and provider creation.
- Enhanced error handling and context detection in tools.
- Improved project resolution logic to streamline tool execution.
- Added new functionality for agent creation and configuration management in setup.

lib/setup/config.ts

@@ -0,0 +1,88 @@
+/**
+ * setup/config.ts — Plugin config writer (openclaw.json).
+ *
+ * Handles: model tier config, devClawAgentIds, tool restrictions, subagent cleanup.
+ */
+import fs from "node:fs/promises";
+import path from "node:path";
+import type { Tier } from "../tiers.js";
+
+function openclawConfigPath(): string {
+  return path.join(process.env.HOME ?? "/home/lauren", ".openclaw", "openclaw.json");
+}
+
+/**
+ * Write DevClaw model tier config and devClawAgentIds to openclaw.json plugins section.
+ *
+ * Also configures:
+ * - Tool restrictions (deny sessions_spawn, sessions_send) for DevClaw agents
+ * - Subagent cleanup interval (30 days) to keep development sessions alive
+ *
+ * Read-modify-write to preserve existing config.
+ */
+export async function writePluginConfig(
+  models: Record<Tier, string>,
+  agentId?: string,
+  projectExecution?: "parallel" | "sequential",
+): Promise<void> {
+  const configPath = openclawConfigPath();
+  const config = JSON.parse(await fs.readFile(configPath, "utf-8"));
+
+  ensurePluginStructure(config);
+  config.plugins.entries.devclaw.config.models = { ...models };
+
+  if (projectExecution) {
+    config.plugins.entries.devclaw.config.projectExecution = projectExecution;
+  }
+
+  configureSubagentCleanup(config);
+
+  if (agentId) {
+    addDevClawAgentId(config, agentId);
+    addToolRestrictions(config, agentId);
+  }
+
+  const tmpPath = configPath + ".tmp";
+  await fs.writeFile(tmpPath, JSON.stringify(config, null, 2) + "\n", "utf-8");
+  await fs.rename(tmpPath, configPath);
+}
+
+// ---------------------------------------------------------------------------
+// Private helpers
+// ---------------------------------------------------------------------------
+
+function ensurePluginStructure(config: Record<string, unknown>): void {
+  if (!config.plugins) config.plugins = {};
+  const plugins = config.plugins as Record<string, unknown>;
+  if (!plugins.entries) plugins.entries = {};
+  const entries = plugins.entries as Record<string, unknown>;
+  if (!entries.devclaw) entries.devclaw = {};
+  const devclaw = entries.devclaw as Record<string, unknown>;
+  if (!devclaw.config) devclaw.config = {};
+}
+
+function configureSubagentCleanup(config: Record<string, unknown>): void {
+  if (!config.agents) config.agents = {};
+  const agents = config.agents as Record<string, unknown>;
+  if (!agents.defaults) agents.defaults = {};
+  const defaults = agents.defaults as Record<string, unknown>;
+  if (!defaults.subagents) defaults.subagents = {};
+  (defaults.subagents as Record<string, unknown>).archiveAfterMinutes = 43200;
+}
+
+function addDevClawAgentId(config: Record<string, unknown>, agentId: string): void {
+  const devclaw = (config as any).plugins.entries.devclaw.config;
+  const existing: string[] = devclaw.devClawAgentIds ?? [];
+  if (!existing.includes(agentId)) {
+    devclaw.devClawAgentIds = [...existing, agentId];
+  }
+}
+
+function addToolRestrictions(config: Record<string, unknown>, agentId: string): void {
+  const agent = (config as any).agents?.list?.find((a: { id: string }) => a.id === agentId);
+  if (agent) {
+    if (!agent.tools) agent.tools = {};
+    agent.tools.deny = ["sessions_spawn", "sessions_send"];
+    delete agent.tools.allow;
+  }
+}