provider

type LarkNativeCLICommand struct {
	Dir   string
	Name  string
	Args  []string
	Stdin string
}

type LarkNativeCLIRunner interface {
	Run(ctx context.Context, cmd LarkNativeCLICommand) ([]byte, error)
}

type LarkNativeDocAdapter interface {
	// CheckCapability 探测 lark-cli 是否支持原生文档写入。
	CheckCapability(ctx context.Context) error
	// CreateNativeDoc 创建原生文档，返回 docx/doc 对象。
	CreateNativeDoc(ctx context.Context, input NativeDocCreateInput) (NativeDocResult, error)
	// UpdateNativeDoc 更新已有原生文档正文。
	UpdateNativeDoc(ctx context.Context, input NativeDocUpdateInput) (NativeDocResult, error)
	// UploadMedia 上传图片/渲染资产，返回 provider media token。
	UploadMedia(ctx context.Context, input MediaUploadInput) (string, error)
	// InspectObjectType 查询远端对象类型（docx/doc/file）。
	InspectObjectType(ctx context.Context, docToken string) (string, error)
}

type LarkNativeDocCLIAdapter struct {
	// contains filtered or unexported fields
}

type MediaUploadInput struct {
	Root      string
	DocToken  string
	Path      string // vault-relative artifact 路径
	MediaType string
	Caption   string
	Width     int
}

type NativeDocCreateInput struct {
	Title       string
	FolderToken string
	PlanJSON    []byte
	ContentPath string
}

type NativeDocResult struct {
	Token string // doc token / file token
	URL   string
	Type  string // docx / doc / file
}

type NativeDocUpdateInput struct {
	Title       string
	DocToken    string
	PlanJSON    []byte
	ContentPath string
	ExistingURL string
}