dingtalk-workspace-cli/internal/shortcut/smart/latest_minutes.go

// Copyright 2026 Alibaba Group
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

package smart

import (
	apperrors "github.com/DingTalk-Real-AI/dingtalk-workspace-cli/internal/errors"
	"github.com/DingTalk-Real-AI/dingtalk-workspace-cli/internal/shortcut"
)

// LatestMinutes: fetch the details of MY most recent minutes (听记) in one step.
//
// Steps:
//  1. list my minutes via list_by_keyword_and_time_range (belongingConditionId
//     = "created"), optionally filtered by --keyword;
//  2. pick the newest entry (largest create time, falling back to the first
//     item) and read its taskUuid;
//  3. print that minute's basic info via get_minutes_basic_info.
//
// If the list is empty it reports "暂无妙记" instead of failing obscurely.
//
//	dws minutes +latest-minutes
//	dws minutes +latest-minutes --keyword 周会
var LatestMinutes = shortcut.Shortcut{
	Service:     "minutes",
	Command:     "+latest-minutes",
	Product:     "minutes",
	Description: "取我最新的一条妙记（听记）详情",
	Intent: "当你只想快速看回自己最近的一条会议听记，却不想先翻列表、复制 taskUuid 再查详情时使用；" +
		"内部先列出你创建的听记（可用 --keyword 缩小范围），自动挑出最新的一条，再拉取它的基础信息（标题、创建人、时间、访问链接等）。" +
		"这是只读操作，不会修改任何听记；若你名下没有任何听记则提示「暂无妙记」。",
	Risk: shortcut.RiskRead,
	Flags: []shortcut.Flag{
		{Name: "keyword", Type: shortcut.FlagString, Desc: "按关键字过滤听记（可选）", Required: false},
	},
	Tips: []string{
		`dws minutes +latest-minutes`,
		`dws minutes +latest-minutes --keyword 周会`,
	},
	Execute: func(rt *shortcut.RuntimeContext) error {
		// Step 1 — list my minutes (newest first). belongingConditionId /
		// maxResults / keyword mirror helpers.callListByKeywordRange.
		listArgs := map[string]any{
			"belongingConditionId": "created",
			"maxResults":           float64(20),
		}
		if kw := rt.Str("keyword"); kw != "" {
			listArgs["keyword"] = kw
		}
		data, err := rt.CallMCPData("minutes", "list_by_keyword_and_time_range", listArgs)
		if err != nil {
			return err
		}

		// Step 2 — locate the newest minute's taskUuid.
		taskUUID := latestMinutesTaskUUID(data)
		if taskUUID == "" {
			return apperrors.NewValidation("暂无妙记")
		}

		// Step 3 — print its basic info (taskUuid param mirrors helper).
		return rt.CallMCP("get_minutes_basic_info", map[string]any{
			"taskUuid": taskUUID,
		})
	},
}

// latestMinutesItems walks a list_by_keyword_and_time_range response and returns
// its minutes entries. The gateway wraps the list under one of several common
// container keys, so we probe them defensively before scanning for a bare list.
func latestMinutesItems(data map[string]any) []map[string]any {
	for _, key := range []string{"result", "list", "minutesList", "items", "data", "records"} {
		if arr, ok := data[key].([]any); ok {
			return latestMinutesToMaps(arr)
		}
		// Some responses nest the list one level deeper, e.g. {"data": {"list": [...]}}.
		if inner, ok := data[key].(map[string]any); ok {
			for _, k2 := range []string{"list", "minutesList", "items", "records", "result"} {
				if arr, ok := inner[k2].([]any); ok {
					return latestMinutesToMaps(arr)
				}
			}
		}
	}
	return nil
}

func latestMinutesToMaps(arr []any) []map[string]any {
	out := make([]map[string]any, 0, len(arr))
	for _, it := range arr {
		if m, ok := it.(map[string]any); ok {
			out = append(out, m)
		}
	}
	return out
}

// latestMinutesTaskUUID picks the newest minute's taskUuid: the item with the
// largest numeric create time, falling back to the first item that carries a
// taskUuid (lists come back newest-first).
func latestMinutesTaskUUID(data map[string]any) string {
	items := latestMinutesItems(data)
	if len(items) == 0 {
		return ""
	}

	best := ""
	var bestTime float64
	haveTime := false
	firstUUID := ""

	for _, m := range items {
		uuid := latestMinutesUUID(m)
		if uuid == "" {
			continue
		}
		if firstUUID == "" {
			firstUUID = uuid
		}
		if t, ok := latestMinutesCreateTime(m); ok {
			if !haveTime || t > bestTime {
				haveTime = true
				bestTime = t
				best = uuid
			}
		}
	}

	if haveTime && best != "" {
		return best
	}
	return firstUUID
}

func latestMinutesUUID(m map[string]any) string {
	for _, key := range []string{"taskUuid", "taskUUID", "uuid", "id"} {
		if s, ok := m[key].(string); ok && s != "" {
			return s
		}
	}
	return ""
}

func latestMinutesCreateTime(m map[string]any) (float64, bool) {
	for _, key := range []string{"createTime", "gmtCreate", "startTime", "createTimeStart"} {
		if v, ok := m[key].(float64); ok {
			return v, true
		}
	}
	return 0, false
}

func init() {
	shortcut.Register(LatestMinutes)
}