70af40e986
- 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.
97 lines
3.7 KiB
TypeScript
97 lines
3.7 KiB
TypeScript
/**
|
|
* task_update — Change issue state programmatically.
|
|
*
|
|
* Use cases:
|
|
* - Orchestrator or worker needs to change state without full pickup/complete flow
|
|
* - Manual status adjustments (e.g., Planning → To Do after approval)
|
|
* - Failed auto-transitions that need correction
|
|
*/
|
|
import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
|
|
import { jsonResult } from "openclaw/plugin-sdk";
|
|
import type { ToolContext } from "../types.js";
|
|
import { log as auditLog } from "../audit.js";
|
|
import { STATE_LABELS, type StateLabel } from "../providers/provider.js";
|
|
import { requireWorkspaceDir, resolveProject, resolveProvider } from "../tool-helpers.js";
|
|
|
|
export function createTaskUpdateTool(api: OpenClawPluginApi) {
|
|
return (ctx: ToolContext) => ({
|
|
name: "task_update",
|
|
label: "Task Update",
|
|
description: `Change issue state programmatically. Use this when you need to update an issue's status without going through the full pickup/complete flow.
|
|
|
|
Use cases:
|
|
- Orchestrator or worker needs to change state manually
|
|
- Manual status adjustments (e.g., Planning → To Do after approval)
|
|
- Failed auto-transitions that need correction
|
|
- Bulk state changes
|
|
|
|
Examples:
|
|
- Simple: { projectGroupId: "-123456789", issueId: 42, state: "To Do" }
|
|
- With reason: { projectGroupId: "-123456789", issueId: 42, state: "To Do", reason: "Approved for development" }`,
|
|
parameters: {
|
|
type: "object",
|
|
required: ["projectGroupId", "issueId", "state"],
|
|
properties: {
|
|
projectGroupId: {
|
|
type: "string",
|
|
description: "Telegram/WhatsApp group ID (key in projects.json)",
|
|
},
|
|
issueId: {
|
|
type: "number",
|
|
description: "Issue ID to update",
|
|
},
|
|
state: {
|
|
type: "string",
|
|
enum: STATE_LABELS,
|
|
description: `New state for the issue. One of: ${STATE_LABELS.join(", ")}`,
|
|
},
|
|
reason: {
|
|
type: "string",
|
|
description: "Optional audit log reason for the state change",
|
|
},
|
|
},
|
|
},
|
|
|
|
async execute(_id: string, params: Record<string, unknown>) {
|
|
const groupId = params.projectGroupId as string;
|
|
const issueId = params.issueId as number;
|
|
const newState = params.state as StateLabel;
|
|
const reason = (params.reason as string) ?? undefined;
|
|
const workspaceDir = requireWorkspaceDir(ctx);
|
|
|
|
const { project } = await resolveProject(workspaceDir, groupId);
|
|
const { provider, type: providerType } = resolveProvider(project);
|
|
|
|
const issue = await provider.getIssue(issueId);
|
|
const currentState = provider.getCurrentStateLabel(issue);
|
|
if (!currentState) {
|
|
throw new Error(`Issue #${issueId} has no recognized state label. Cannot perform transition.`);
|
|
}
|
|
|
|
if (currentState === newState) {
|
|
return jsonResult({
|
|
success: true, issueId, state: newState, changed: false,
|
|
message: `Issue #${issueId} is already in state "${newState}".`,
|
|
project: project.name, provider: providerType,
|
|
});
|
|
}
|
|
|
|
await provider.transitionLabel(issueId, currentState, newState);
|
|
|
|
await auditLog(workspaceDir, "task_update", {
|
|
project: project.name, groupId, issueId,
|
|
fromState: currentState, toState: newState,
|
|
reason: reason ?? null, provider: providerType,
|
|
});
|
|
|
|
return jsonResult({
|
|
success: true, issueId, issueTitle: issue.title,
|
|
state: newState, changed: true,
|
|
labelTransition: `${currentState} → ${newState}`,
|
|
project: project.name, provider: providerType,
|
|
announcement: `🔄 Updated #${issueId}: "${currentState}" → "${newState}"${reason ? ` (${reason})` : ""}`,
|
|
});
|
|
},
|
|
});
|
|
}
|