fix(agent-core-v2): correct goal lifecycle error guidance (#1743)

* fix(agent-core-v2): correct goal lifecycle error guidance

* refactor(agent-core-v2): remove unused goal service API

Author: chengluyu

.changeset/fix-goal-error-guidance.md

@@ -0,0 +1,5 @@
+---
+"@moonshot-ai/kimi-code": patch
+---
+
+Correct the guidance text shown when a goal cannot be paused or resumed.

packages/agent-core-v2/src/agent/goal/errors.ts

@@ -44,7 +44,7 @@ export const GoalErrors = {
       title: 'Invalid goal status transition',
       retryable: false,
       public: true,
-      action: 'Use a status allowed for this actor (complete, blocked, or impossible).',
+      action: 'Only an active goal can be paused; resume a blocked goal with `/goal resume`.',
     },
     'goal.metadata_reserved': {
       title: 'Goal metadata is reserved',
@@ -56,7 +56,7 @@ export const GoalErrors = {
       title: 'Goal is not resumable',
       retryable: false,
       public: true,
-      action: 'Only paused goals can be resumed.',
+      action: 'Only paused or blocked goals can be resumed.',
     },
     'goal.unsupported_agent': {
       title: 'Goals are unavailable for subagents',

packages/agent-core-v2/src/agent/goal/goalService.ts

@@ -326,13 +326,6 @@ export class AgentGoalService extends Disposable implements IAgentGoalService {
     return { goal: state === null ? null : this.toSnapshot(state) };
   }
 
-  getActiveGoal(): GoalSnapshot | null {
-    this.assertSupportedAgent();
-    const state = this.goalState;
-    if (state === null || state.status !== 'active') return null;
-    return this.toSnapshot(state);
-  }
-
   isGoalToolTarget(turnId: number, goalId: string): boolean {
     this.assertSupportedAgent();
     return this.goalTurnTargets.get(turnId) === goalId;

packages/agent-core-v2/test/agent/goal/goal.test.ts

@@ -1505,7 +1505,7 @@ describe('goal error catalog metadata', () => {
       title: 'Invalid goal status transition',
       retryable: false,
       public: true,
-      action: 'Use a status allowed for this actor (complete, blocked, or impossible).',
+      action: 'Only an active goal can be paused; resume a blocked goal with `/goal resume`.',
     });
     expect(errorInfo('goal.metadata_reserved')).toEqual({
       title: 'Goal metadata is reserved',
@@ -1517,7 +1517,7 @@ describe('goal error catalog metadata', () => {
       title: 'Goal is not resumable',
       retryable: false,
       public: true,
-      action: 'Only paused goals can be resumed.',
+      action: 'Only paused or blocked goals can be resumed.',
     });
     expect(errorInfo('goal.unsupported_agent')).toEqual({
       title: 'Goals are unavailable for subagents',